DialogPage.SaveSettingsToStorage, méthode

Article
08/01/2012

Appelé par Visual Studio pour enregistrer les paramètres d'une page de dialogue dans le stockage local, en général le Registre.

Espace de noms : Microsoft.VisualStudio.Shell
Assembly : Microsoft.VisualStudio.Shell.11.0 (dans Microsoft.VisualStudio.Shell.11.0.dll)

Syntaxe

'Déclaration
Public Overridable Sub SaveSettingsToStorage

public virtual void SaveSettingsToStorage()

Implémentations

IProfileManager.SaveSettingsToStorage()

Remarques

SaveSettingsToStorage implémente IProfileManager.SaveSettingsToStorage.

Cette méthode est appelée pour enregistrer les paramètres d'une page de dialogue (et non au disque) au stockage local, en général du Registre.

L'implémentation par défaut fait les choses suivantes :

Enregistre les informations de paramètre pour toutes les propriétés de l'objet Automation de la page de dialogue qui prennent en charge la conversion à une chaîne via TypeConverter.
Enregistre des paramètres dans le Registre sous le Registre VSROOT\SettingsRegistryPath, où
- VSROOT est l'entrée du Registre de niveau supérieur spécifique à la version de Visual Studio, en général
  
  HKEY_CURRENT_USER\logiciel\Microsoft\VisualStudio\Version, où
  
  Version est la version de Visual Studio.
  
  Une autre racine peut être spécifiée lorsque le shell de Visual Studio est initialisé.Pour plus d'informations sur la manière de spécifier une autre racine dans le Registre, consultez Commutateurs de la ligne de commande (Kit de développement logiciel Visual Studio).
- SettingsRegistryPath est la valeur qui est retournée par SettingsRegistryPath.

[!REMARQUE]

En général, une instance d'une classe de page de dialogue est son propre objet Automation.Par conséquent, les propriétés qui sont enregistrées sont ceux de la classe de base d'DialogPage.Toutefois, si AutomationObject retourne un autre objet, c'est que des propriétés de l'objet, et non les propriétés de la classe, qui sont enregistrées.

Lorsque les propriétés publiques d'une page de dialogue sont modifiées par le biais de sa fenêtre de dialogue, SaveSettingsToStorage est automatiquement appelé pour enregistrer l'état au stockage local (par défaut, le Registre).

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.