DialogPage.SaveSettingsToStorage Method
Called by Visual Studio to store the settings of a dialog page in local storage, typically the registry.
Namespace: Microsoft.VisualStudio.Shell
Assembly: Microsoft.VisualStudio.Shell.12.0 (in Microsoft.VisualStudio.Shell.12.0.dll)
Syntax
'Declaration
Public Overridable Sub SaveSettingsToStorage
public virtual void SaveSettingsToStorage()
public:
virtual void SaveSettingsToStorage()
abstract SaveSettingsToStorage : unit -> unit
override SaveSettingsToStorage : unit -> unit
public function SaveSettingsToStorage()
Implements
IProfileManager.SaveSettingsToStorage()
Remarks
SaveSettingsToStorage implements IProfileManager.SaveSettingsToStorage.
This method is called to save the settings of a dialog page to local (as opposed to disk) storage, typically from the registry.
The default implementation does the following things:
Saves setting information for all the properties of the dialog page's automation object that support conversion to a string through TypeConverter.
Stores settings in registry under the registry VSROOT\SettingsRegistryPath, where
VSROOT is the Visual Studio version-specific top-level registry entry, typically
HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\Version, where
Version is the Visual Studio version.
An alternative root can be specified when the Visual Studio shell is initialized. For more information about how to specify an alternative root in the registry, see Command-Line Switches (Visual Studio SDK).
SettingsRegistryPath is the value that is returned by SettingsRegistryPath.
Note
Typically, an instance of a dialog page class is its own automation object. Therefore, properties that are stored are those of the DialogPage base class. However, if AutomationObject returns another object, it is that object's properties, and not the properties of the class, that are stored.
When the public properties of a dialog page are modified through its dialog window, SaveSettingsToStorage is automatically called to save the state to local storage (by default, the registry).
.NET Framework Security
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.
See Also
Reference
Microsoft.VisualStudio.Shell Namespace