Prise en charge pour les catégories de paramètres
Une catégorie de paramètres se compose d'un groupe d'options qui personnalisent l'environnement de développement intégré (IDE) (IDE). Par exemple, les paramètres peuvent contrôler la disposition des fenêtres de Visual Studio et le contenu des menus. Pour plus d'informations, consultez Paramètres Visual Studio.
Sur le bouton Importation et exportation de paramètres de menu d' Outils pour démarrer Assistant paramètres d'importation et d'exportation. L'Assistant offre trois options : exporter, importer, ou réinitialisez les paramètres. sélectionner l'exportation, par exemple, ouvre la page de Choisissez des paramètres pour exporter de l'Assistant.
le contrôle d'arborescence dans le volet de navigation de cette page répertorie des catégories. Une catégorie est un groupe de paramètres relatifs qui s'affichent en tant que « point de paramètres personnalisés », c. autrement dit., comme case à cocher. Vous utilisez ces cases à cocher sélectionner des catégories pour rendre persistantes dans un fichier de .vsettings. L'Assistant vous permet de nommer le fichier de .vsettings et spécifier son chemin d'accès.
Notes
Les paramètres sont stockés ou restaurés comme une catégorie, et différents noms de paramètres ne s'affichent pas dans l'Assistant.
Managed package (MPF) prend en charge la création de catégories de paramètres avec un minimum de code supplémentaire.
vous créez un VSPackage pour fournir un conteneur pour la catégorie par sous-classement la classe d' Package .
Vous créez la catégorie elle-même en le dérivant de la classe d' DialogPage .
vous connectez les deux avec ProvideProfileAttribute.
Prise en charge pour les catégories de paramètres
La classe d' Package permet de créer des catégories. la classe d' DialogPage implémente une catégorie. L'implémentation par défaut d' DialogPage propose ses propriétés publiques à un utilisateur comme une catégorie. Pour plus d'informations, consultez Procédure pas - à - pas : créer une catégorie de paramètres.
La classe d' DialogPage implémente IProfileManager, qui fournit la persistance pour les pages options et les paramètres utilisateur. L' LoadSettingsFromXml et les méthodes d' SaveSettingsToXml persistantes les paramètres dans un fichier .vssettings que Visual Studio fournit en tant qu' IVsSettingsReader ou IVsSettingsWriter, respectivement. La méthode d' ResetSettings réinitialise les paramètres par défaut.
La classe d' DialogPage fournit une implémentation de la méthode de LoadSettingsFromXml qui lit des paires nom-valeur de l'alimentation XML, et utilise la réflexion pour découvrir les propriétés publiques dans la classe dérivée d' DialogPage . Les propriétés dont les noms correspondent à des paires nom-valeur sont fournies les valeurs correspondantes.
L'implémentation par défaut d' SaveSettingsToXml utilise la réflexion pour découvrir les propriétés publiques dans la classe dérivée d' DialogPage et écrit les noms de propriété et les valeurs au flux XML sous forme de paires nom-valeur.
chemin d'accès au Registre de catégorie de paramètres
Le chemin d'accès au Registre des paramètres est déterminé en combinant ApplicationRegistryRoot, le mot, UserSettings, la catégorie de paramètres, et le nom du point de paramètres personnalisés. Les noms des paramètres et son point de paramètres personnalisés sont jointes et séparés par un trait de soulignement pour former le nom canonique et non localisé qui apparaît dans le Registre. par exemple, si la catégorie de paramètres est « ma catégorie », le nom de point de paramètres personnalisés « mes paramètres », et le \SOFTWARE\Microsoft\VisualStudio\8.0Exp, then the settings category has the registry key, HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\8.0Exp\UserSettings\My Category_My Settings d'ApplicationRegistryRoot HKEY_LOCAL_MACHINE.
Notes
le nom canonique n'apparaît pas dans une interface utilisateur (UI).Elles sont utilisées pour associer un nom lisible à la catégorie de paramètres, comme un identificateur programmatique (progid).
attribut de catégorie de paramètres
ProvideProfileAttribute détermine le mappage des catégories à des points de paramètres personnalisés dans Assistant paramètres d'importation et d'exportation en associant une catégorie avec le VSPackage fournis par. Prenons le fragment de code suivant :
<ProvideProfile(GetType(OptionsPageGeneral), "My Category", "My Settings", 106, 107, True, DescriptionResourceID:=108),
Guid("B0002DC2-56EE-4931-93F7-70D6E9863940")>
Public Class MyPackage
Inherits Package
[ProvideProfile(typeof(OptionsPageGeneral),"My Category", "My Settings", 106, 107, true, DescriptionResourceID = 108)]
[Guid("B0002DC2-56EE-4931-93F7-70D6E9863940")]
public class MyPackage : Package
ID de ressource 106 correspond à « ma catégorie », 107 à mes paramètres, et » 108 « différentes options ». Cela déclare qu' MyPackage fournit la catégorie, mes paramètres de Category_My. la catégorie est fournie par la classe d' OptionsPageGeneral , qui doit implémenter IProfileManager. Les paramètres de cette catégorie sont les propriétés publiques de la classe d' OptionsPageGeneral .
dans Assistant paramètres d'importation et d'exportation, le point de paramètres a le nom, mes paramètres. Lorsque le point de paramètres est sélectionné, la description, différentes options, s'affiche. le nom et la description de point de paramètres sont pris des ressources de type chaîne localisées.
Voir aussi
Tâches
Procédure pas - à - pas : créer une page d'options
Concepts
Exemples d'extensibilité Visual Studio