IProfileManager, interface

Article
08/01/2012

Interface implémentée par des classes prenant en charge les VSPackages en persistant leurs informations d'état via le mécanisme de paramètres de Visual Studio.

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

Syntaxe

'Déclaration
Public Interface IProfileManager

public interface IProfileManager

Le type IProfileManager expose les membres suivants.

Méthodes

	Nom	Description
	LoadSettingsFromStorage	Lit la configuration d'un VSPackage du stockage local (en général le Registre) et des mises à jour son état.
	LoadSettingsFromXml	Écrit la configuration d'un VSPackage au disque à l'aide de le mécanisme de paramètres de Visual Studio lorsque l'option d'exportation d'une fonctionnalité de Paramètres d'importation/exportation disponible dans le menu d'Outils d'IDE est sélectionnée par un utilisateur.
	ResetSettings	Réinitialise les paramètres utilisateurs.
	SaveSettingsToStorage	Écrit la configuration d'un VSPackage à la mise à jour suivante d'état de stockage local (en général le Registre).
	SaveSettingsToXml	Écrit la configuration d'un VSPackage au disque à l'aide de le mécanisme de paramètres de Visual Studio lorsqu'une option d'importation de la commande de Paramètres d'importation/exportation sur le menu d'Outils d'IDE est sélectionnée par un utilisateur.

Début

Remarques

Les classes implémentant IProfileManager, doit implémentent également IComponent, qui peut être effectuée en dérivant la classe d'Component.

La fourniture de la prise en charge de paramètres de Visual Studio pour un VSPackage doit être effectuée en implémentant IProfileManager sur une indépendante de classe de la classe implémentant le VSPackage lui-même.

Cela est dû au fait qu'une classe fournissant la prise en charge d'IProfileManager sera instanciée lorsqu'un utilisateur choisit la commande de Paramètres d'importation/exportation sur le menu d'Outils d'enregistrer ou extraire l'état de Visual Studio.

La classe de base du composant fait pour la classe dérivée et c'est la façon la plus facile de remplir la condition.

L'objet implémentant IProfileManager est enregistré comme prendre en charge un VSPackage donné en appliquant ProvideProfileAttribute à l'implémentation de package.Pour plus d'informations, consultez Rendre des paramètres et ProvideProfileAttribute.

Implémentez l'SaveSettingsToXml et l'LoadSettingsFromXml pour utiliser les interfaces d'IVsSettingsWriter et d'IVsSettingsReader pour enregistrer l'état d'un VSPackage au stockage de paramètres de Visual Studio de sur- disque disque.

Implémentez SaveSettingsToStorage et LoadSettingsFromStorage pour enregistrer les informations au stockage local (en général le Registre), qui VSPackage.

De Visual Studio d'environnement les appels LoadSettingsFromStorage d'abord puis SaveSettingsToXml pour des exportations de paramètres.

l'LoadSettingsFromXml puis SaveSettingsToStorage sont appelés pour des opérations d'importation de paramètres.

Pour plus d'informations, consultez Comment : Paramètres d'importation à l'aide de managed package et Comment : Exporter des paramètres à l'aide de managed package.

Visual Studio appelle également LoadSettingsFromStorage lorsqu'il démarre un VSPackage à initialiser correctement son état.

Remarques à l'attention des implémenteurs

Implémentez cette interface dans une classe lorsqu'un VSPackage a besoin pour enregistrer ou extraire des paramètres à partir du disque via du mécanisme de paramètres de Visual Studio, ainsi que conserver son état synchronisé avec le stockage local (tel que le Registre).

Dimensionné en implémentant IProfileManager, implémentez doit également IComponent.