Visual Studio. Settings Namespace
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
An implementation of the SettingsManager class that allows applications to access settings from Visual Studio or an isolated shell, either of which is selected by its
Arguments for a change in the application's idle state.
Handles merging operations for setting collections.
A setting value serialized as a string along with an associated name, version, and machine-local flag.
This exception is thrown from ISettingsManager when attempting to create a setting whose name exceeds the length limit imposed by the roaming settings server (currently 128 characters).
Event args for a settings event.
This is the gateway class to reach for the settings stored inside the Visual Studio. It provides two basic functionality. It allows to search for properties and collections inside the scopes. It hands the SettingsStore and WritableSettingsStore classes for further manipulation of the collections and properties within the scopes.
A factory class that constructs an ISettingsManager.
Abstract class for reading/enumerating the selected scope's collections and properties. It is obtained from GetReadOnlySettingsStore(SettingsScope) method.
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 file system. Likewise, separator is '' (back-slash) character. Example of a sub-collection path would be: "Root Collection\Internal Collection\Leaf Collection".
This exception is thrown (from ISettingsManager, ISettingsList, etc.) when a setting value is given whose serialized representation exceeds the size limit on the roaming settings server (currently 1MB).
A non-generic way to refer to a StoreLogPropertyDefinition<T>, and also the place where the well-known properties are defined.
A store log property without a value assigned.
A non-generic way to refer to a StoreLogPropertyInstance<T>.
A store log property with a specific value.
A setting value serialized as a string along with a flag indicating whether the value contains machine-local content.
A setting value serialized as a string along with an associated version and machine-local flag.
Abstract class for both reading and writing the selected scope's collections and properties. It is obtained from GetWritableSettingsStore(SettingsScope) method.
This class is derived from the SettingsStore hence it inherits all the functionalities from it. It adds property and collection manipulation abilities on top of it.
Stores and retrieves strings. Used as an abstraction over the settings service in the hub and unit-test mocks.
Handles merging operations for setting collections.
Translates between private names and shared names. This allows an application to isolate its settings from other apps by inserting a prefix or suffix.
A collection of settings. The collection is ordered but the server is order-agnostic. Items can be added only at the front but removed from anywhere. The collection is preserved by the server in the order it was created. Keys are treated as case insensitive.
Stores and retrieves settings as well as handling synchronization between applications and machines.
The public API presented by the service module. Implementers should expect a separate instance to be created for (at least) each client or (at most) each client request.
A subset of settings (either a single setting or all settings matching a wildcard pattern) for which one can subscribe to change events.
A logger for settings store update records.
Adds ambient context to an IStoreUpdateLogger. Ambient context is implemented via the SetContext(StoreLogPropertyInstance) method, which allows the caller to supply properties which will be set on all events emitted within the current execution context until the returned IDisposable is disposed.
Stores and retrieves strings. Used as an abstraction over the registry and unit-test mocks.
This enumeration is used to specify the folder that Visual Studio uses to keep various files for different purposes like cache files, backup files or template files.
This enumeration is returned as a result of a querying call to GetPropertyScope or GetCollectionScope methods of the SettingsManager class to learn the enclosing scopes of the provided property or collection. This is a flags enumeration meaning that it is possible that more than one enumeration flag could be set for the corresponding scopes.
The result of an operation to retrieve a value from the settings store.
Settings event that may be fired by the settings service.
An operation performed on an ISettingsList.
This enumeration is used to specify the scope of the settings that is retrieved from the SettingsManager class.
Data types of the properties that are stored inside the collections.
A handler for async events that returns a Task
A delegate that creates a stoage object, used by the constructor of the storage factory.
A delegate that creates a storage object, used by the constructor of the storage factory.