Spécification de l’emplacement du fichier VSPackage au shell Visual Studio
Visual Studio doit être en mesure de localiser la DLL d’assembly pour charger vsPackage. Vous pouvez le localiser de différentes façons, comme décrit dans le tableau suivant.
| Méthode | Description |
|---|---|
| Utilisez la clé de Registre CodeBase. | La clé CodeBase peut être utilisée pour diriger Visual Studio pour charger l’assembly VSPackage à partir de n’importe quel chemin de fichier complet. La valeur de la clé doit être le chemin du fichier vers la DLL. Il s’agit de la meilleure façon d’avoir Visual Studio à charger votre assembly de package. Cette technique est parfois appelée « Technique de répertoire d’installation codeBase/privé ». Lors de l’inscription, la valeur du codebase est passée aux classes d’attributs d’inscription par le biais d’une instance du RegistrationAttribute.RegistrationContext type. |
| Placez la DLL dans le répertoire PrivateAssemblies . | Placez l’assembly dans le sous-répertoire PrivateAssemblies du répertoire Visual Studio. Les assemblys situés dans PrivateAssemblies sont détectés automatiquement, mais ne sont pas visibles dans la boîte de dialogue Ajouter des références . La différence entre PrivateAssemblies et PublicAssemblies est que les assemblys dans PublicAssemblies sont énumérés dans la boîte de dialogue Ajouter des références. Si vous avez choisi de ne pas utiliser la technique « Répertoire d’installation codeBase/privé », vous devez l’installer dans le répertoire PrivateAssemblies . |
| Utilisez un assembly nommé fort et la clé de Registre d’assembly. | La clé d’assembly peut être utilisée pour diriger explicitement Visual Studio pour charger un assembly VSPackage nommé fort. La valeur de la clé doit être le nom fort de l’assembly. |
| Placez la DLL dans le répertoire PublicAssemblies . | Enfin, l’assembly peut également être placé dans le sous-répertoire PublicAssemblies . Les assemblys situés dans PublicAssemblies sont détectés automatiquement et apparaissent également dans la boîte de dialogue Ajouter des références dans Visual Studio. Les assemblys VSPackage ne doivent être placés que dans le répertoire PublicAssemblies s’ils contiennent des composants managés destinés à être réutilisés par d’autres développeurs VSPackage. La majorité des assemblys ne répondent pas à ce critère. |
Remarque
Utilisez des assemblys signés avec nom fort pour tous vos assemblys dépendants. Ces assemblys doivent également être installés dans votre propre répertoire ou dans le Global Assembly Cache (GAC). Cela protège contre les conflits avec les assemblys qui ont le même nom de fichier de base, appelé liaison de nom faible.