This topic has not yet been rated - Rate this topic

SettingsStore Class

Abstract class for reading or enumerating the selected scope's collections and properties. It is obtained from GetReadOnlySettingsStore method.

Object
  Microsoft.VisualStudio.Settings.SettingsStore
    Microsoft.VisualStudio.Settings.WritableSettingsStore

Namespace:  Microsoft.VisualStudio.Settings
Assemblies:   Microsoft.VisualStudio.Settings (in Microsoft.VisualStudio.Settings.dll)
  Microsoft.VisualStudio.Shell.11.0 (in Microsoft.VisualStudio.Shell.11.0.dll)
public abstract class SettingsStore

The SettingsStore type exposes the following members.

  NameDescription
Protected methodSettingsStore
Top
  NameDescription
Public methodCollectionExistsChecks the existence of the collection passed in to this method.
Public methodEqualsDetermines whether the specified object is equal to the current object. (Inherited from Object.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetBoolean(String, String)Returns the value of the requested property whose data type is [!:SettingsType.Int32] as boolean.
Public methodGetBoolean(String, String, Boolean)Returns the value of the requested property whose data type is [!:SettingsType.Int32] as boolean.
Public methodGetHashCodeServes as a hash function for a particular type. (Inherited from Object.)
Public methodGetInt32(String, String)Returns the value of the requested property whose data type is [!:SettingsType.Int32].
Public methodGetInt32(String, String, Int32)Returns the value of the requested property whose data type is [!:SettingsType.Int32].
Public methodGetInt64(String, String)Returns the value of the requested property whose data type is [!:SettingsType.Int64].
Public methodGetInt64(String, String, Int64)Returns the value of the requested property whose data type is [!:SettingsType.Int64].
Public methodGetLastWriteTimeProvides the last write time of the properties and sub-collections immediate to the given collection.
Public methodGetMemoryStreamReturns the value of the requested property whose data type is [!:SettingsType.Binary]. In order to access the underlying byte array at once [!:MemoryStream.ToArray] method can be used.
Public methodGetPropertyCountReturns the number of properties under the given collection.
Public methodGetPropertyNamesReturns the names of properties under the given collection.
Public methodGetPropertyTypeReturns the type of the requested property.
Public methodGetString(String, String)Returns the value of the requested property whose data type is [!:SettingsType.String].
Public methodGetString(String, String, String)Returns the value of the requested property whose data type is [!:SettingsType.String].
Public methodGetSubCollectionCountReturns the number of sub-collections under the given collection.
Public methodGetSubCollectionNamesReturns the names of sub-collections under the given collection.
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Public methodGetUInt32(String, String)Returns the value of the requested property whose data type is [!:SettingsType.Int32].
Public methodGetUInt32(String, String, UInt32)Returns the value of the requested property whose data type is [!:SettingsType.Int32].
Public methodGetUInt64(String, String)Returns the value of the requested property whose data type is [!:SettingsType.Int64].
Public methodGetUInt64(String, String, UInt64)Returns the value of the requested property whose data type is [!:SettingsType.Int64].
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodPropertyExistsChecks the existance of the property passed in to this method.
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)
Top

In the methods of this class, if the collection path is provided as the empty string (""), then it denotes the top level collection. If the property name is empty string, then it denotes the default property of the collection.

Collections can contain properties and sub-collections. Sub-collections paths are described with the separators like directories in the file system. Likewise, the separator is '\' (back-slash) character.

Example of a sub-collection path would be: "Root Collection\Internal Collection\Leaf Collection".

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Did you find this helpful?
(1500 characters remaining)
© 2013 Microsoft. All rights reserved.