Package.ParseToolboxResource, méthode (TextReader, ResourceManager)
Analyse une ressource embarquée en texte de format approprié des informations concernant le type des éléments doivent être ajoutés à boîte à outils.
Espace de noms : Microsoft.VisualStudio.Shell
Assembly : Microsoft.VisualStudio.Shell.11.0 (dans Microsoft.VisualStudio.Shell.11.0.dll)
Syntaxe
'Déclaration
Protected Sub ParseToolboxResource ( _
resourceData As TextReader, _
localizedCategories As ResourceManager _
)
protected void ParseToolboxResource(
TextReader resourceData,
ResourceManager localizedCategories
)
Paramètres
- resourceData
Type : System.IO.TextReader
Un lecteur de texte qui fournit des données d'élément de boîte à outils dans le format a décrit dans les notes.
- localizedCategories
Type : System.Resources.ResourceManager
Un gestionnaire des ressources qui fournit la recherche localisée nomme pour les catégories fournies dans les données de ressources.Ce paramètre peut être null, auquel cas les noms de catégorie sont directement utilisés.
Remarques
La ressource en texte qu'un VSPackage analyse à l'aide de ParseToolboxResource doit être incorporée dans un assembly et un espace de nom accessibles au VSPackage.
Des ressources en texte doivent être ajoutées à un assembly en cliquant avec le bouton droit sur le projet de l'assembly, la sélection Ajouter et Nouvel élément.Du menu de Nouvel élément, sélectionnez ensuite Fichier texte.Une fois que le fichier texte a été ajouté au projet, définissez sa propriété d'Action de génération à Ressource incorporée.
Cette méthode peut être utilisée pour ajouter des éléments à la boîte à outils automatiquement.Les données de ressources sont passées via le paramètre d'resourceData et se composent d'un fichier texte avec le format suivant :
; Comment
[CategoryName]
<class name>, <assembly name>
Le nom de catégorie peut être localisé via le gestionnaire des ressources d'localizedCategories qui est passé à cette méthode.Le paramètre d'localizedCategories peut être null, auquel cas les noms de catégorie ne sont pas localisés.
Le nom de l'assembly peut être un nom qualifié complet ou un nom partiel.Si un nom partiel est passé, l'assembly accédé le plus récemment avec ce nom partiel est chargé.
En traitant des noms de l'assemblyParseToolboxResource, répertoires de recherches uniquement spécifiés dans des clés dans l'entrée du Registre HKEY_CURRENT_USER\logiciel\Microsoft\VisualStudio \ <version>\AssemblyFolders, où le <version> est le numéro de version de la version finale de Visual Studio (par exemple, 8,0)
[!REMARQUE]
Le chemin d'accès racine HKEY_LOCAL_MACHINE\de LOGICIEL\de Microsoft\VisualStudio \ <Version> peut être substitué avec une autre racine lorsque le shell de Visual Studio est initialisé, ou l'utilisation deDefaultRegistryRootAttribute.Pour plus d'informations, Commutateurs de la ligne de commande (Kit de développement logiciel Visual Studio) voyez et DefaultRegistryRootAttribute.
Le format des sous-clés sous HKEY_CURRENT_USER\logiciel\Microsoft\VisualStudio \ <version>\AssemblyFolders est
Nom |
Type |
Données |
Description |
|---|---|---|---|
<FriendlyName> |
REG_SZ |
Une chaîne contenant un chemin qualifié complet à un répertoire qui doit contenir des assemblys l'a utilisé par Visual Studio. |
Le nom de clé, <FriendlyName>, peut être n'importe quelle valeur en sachant qu'il soit unique.La donnée de la clé contient le chemin complet à un répertoire contenant des assemblys à rechercher par ParseToolboxResource |
Tout VSPackage devant utiliser ParseToolboxResource doit s'enregistrer avec l'environnement de Visual Studio comme fourniture des éléments de boîte à outils.
L'attribut ProvideToolboxItemsAttribute doit être appliqué à l'implémentation du VSPackage d'Package.Selon l'implémentation du VSPackage ProvideToolboxFormatAttribute et ProvideToolboxItemConfigurationAttribute peut également être requis.
Pour plus d'informations sur écrire un fournisseur d'élément de boîte à outils, consultez Développement avancées de contrôle de la boîte à outils.
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.