Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Un VSPackage peut définir une ou plusieurs catégories de paramètres, qui sont des groupes de variables d’état qui persistent lorsqu’un utilisateur choisit la commande Paramètres d’importation/exportation dans le menu Outils . Pour activer cette persistance, vous utilisez les API de paramètres dans le Kit de développement logiciel (SDK) Visual Studio.
Une entrée de Registre appelée point de paramètres personnalisés et un GUID définit la catégorie de paramètres d’un VSPackage. Un VSPackage peut prendre en charge plusieurs catégories de paramètres, chacune définie par un point de paramètres personnalisé.
Les implémentations des paramètres basées sur des assemblys d’interopérabilité (à l’aide de l’interface IVsUserSettings) doivent créer un point de configuration personnalisée soit en modifiant le registre, soit en utilisant un script de Registre (.rgs). Pour plus d’informations, consultez Création de scripts de bureau d’enregistrement.
Le code qui utilise Managed Package Framework (MPF) doit créer des points de paramètres personnalisés en attachant un ProvideProfileAttribute à VSPackage pour chaque point de paramètres personnalisés.
Si un vsPackage unique prend en charge plusieurs points de paramètres personnalisés, chaque point de paramètres personnalisé est implémenté par une classe distincte, et chacun est inscrit par une instance unique de la ProvideProfileAttribute classe. Par conséquent, une classe d’implémentation de paramètres peut prendre en charge plusieurs catégories de paramètres.
Détails de l’entrée du Registre de points de paramètres personnalisés
Les points de paramètres personnalisés sont créés dans une entrée de Registre à l’emplacement suivant : HKLM\Software\Microsoft\VisualStudio\<Version>\UserSettings\<CSPName>, où <CSPName> est le nom du point de paramètres personnalisés pris en charge par VSPackage et <version> est la version de Visual Studio, par exemple 8.0.
Note
Le chemin racine de HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Version> peut être remplacé par une autre racine lorsque l’environnement de développement intégré (IDE) visual Studio est initialisé. Pour plus d’informations, consultez Command-Line Commutateurs.
La structure de l’entrée de Registre est illustrée ci-dessous :
HKLM\Software\Microsoft\VisualStudio\<Version>\UserSettings\
<CSPName
>= s '#12345'
Package = '{XXXXXX XXXX XXXX XXXX XXXXXXXXX}'
Category = '{YYYYYY YYYY YYYY YYYY YYYYYYYYY}'
ResourcePackage = '{ZZZZZZ ZZZZ ZZZZ ZZZZ ZZZZZZZZZ}'
AlternateParent = CategoryName
| Nom | Type | Data | Descriptif |
|---|---|---|---|
| (Par défaut) | REG_SZ | Nom du point de paramètres personnalisés | Le nom de la clé, <CSPName>est le nom non localisé du point de paramètres personnalisés.Pour les implémentations basées sur MPF, le nom de la clé est obtenu en combinant les arguments categoryName et objectName du constructeur ProvideProfileAttribute en categoryName_objectName.La clé peut être vide ou contenir l’ID de référence à la chaîne localisée dans une DLL satellite. Cette valeur est obtenue de l’argument objectNameResourceID au ProvideProfileAttribute constructeur. |
| Package | REG_SZ | Identifiant Unique Global (GUID) | GUID du VSPackage qui implémente le point de paramètres personnalisés. Implémentations basées sur MPF utilisant la classe ProvideProfileAttribute, utilisez l’argument du constructeur objectType contenant le VSPackage Type et la réflexion pour obtenir cette valeur. |
| Catégorie | REG_SZ | Identifiant Unique Global (GUID) | GUID identifiant la catégorie de paramètres. Pour les implémentations basées sur des assemblys d’interopérabilité, cette valeur peut être un GUID arbitrairement choisi, que l’IDE Visual Studio transmet aux méthodes ExportSettings et ImportSettings. Toutes les implémentations de ces deux méthodes doivent vérifier leurs arguments GUID. Pour les implémentations basées sur MPF, ce GUID est obtenu par la Type classe implémentant le mécanisme de paramètres Visual Studio. |
| ResourcePackage | REG_SZ | Identifiant Unique Global (GUID) | Optional. Chemin d’accès à la DLL satellite contenant des chaînes localisées dans le cas où l’implémentation de VSPackage ne les fournit pas. MPF utilise la réflexion pour obtenir le VSPackage de la ressource correcte, de sorte que la ProvideProfileAttribute classe ne définit pas cet argument. |
| AlternateParent | REG_SZ | Nom du dossier dans la page Options des outils contenant ce point de paramètres personnalisés. | Optional. Vous devez définir cette valeur uniquement si une implémentation de paramètres prend en charge les pages Options des outils qui utilisent le mécanisme de persistance dans le Kit de développement logiciel (SDK) Visual Studio plutôt que le mécanisme dans le modèle Automation pour enregistrer l’état. Dans ces cas, la valeur de la clé AlternateParent est la topic section de la topic.sub-topic chaîne utilisée pour identifier la page ToolsOptions particulière. Par exemple, pour la page "TextEditor.Basic", la valeur de AlternateParent serait "TextEditor".Lorsque ProvideProfileAttribute génère le point de paramètres personnalisés, il est identique au nom de la catégorie. |