Comment : créer un complément

Les compléments Visual Studio sont déconseillés dans Visual Studio 2013. Vous devriez mettre vos compléments à niveau vers des extensions VSPackage. Pour plus d'informations sur les mises à jour, consultez FAQ : conversion de compléments en extensions VSPackage.

Un complément est une DLL compilée qui s'exécute dans l'environnement de développement intégré (IDE) de Visual Studio. Sa compilation protège votre propriété intellectuelle et améliore les performances. Même si vous pouvez créer des compléments manuellement, il est toutefois plus facile d'utiliser l'Assistant Complément. L'Assistant crée un complément fonctionnel de base que vous pouvez exécuter immédiatement après sa création. Une fois que l'Assistant Complément a généré le programme de base, vous pouvez y ajouter du code et le personnaliser.

L'Assistant Complément vous permet de fournir un nom complet et une description de votre complément. Ils s'afficheront dans le Gestionnaire de compléments. Vous pouvez indiquer à l'Assistant de générer un code qui ajoute au menu Outils une commande permettant d'ouvrir le complément. Vous pouvez également choisir d'afficher une boîte de dialogue À propos de personnalisée pour votre complément. Une fois l'Assistant terminé, votre nouveau projet n'a qu'une classe, appelée Connect, qui implémente le complément.

Notes

Il est possible que pour certains des éléments de l'interface utilisateur de Visual Studio, votre ordinateur affiche des noms ou des emplacements différents de ceux indiqués dans les instructions suivantes.Ces éléments dépendent de l'édition de Visual Studio dont vous disposez et des paramètres que vous utilisez.Pour plus d'informations, consultez Paramètres Visual Studio.

Pour créer un complément en utilisant l'Assistant Complément

  1. Créez un projet de complément Visual Studio. Dans le menu Fichier, pointez sur Nouveau, puis cliquez sur Projet. Accédez à Extensibilité dans le nœud Autres types de projets. L'Assistant Complément démarre lorsque vous créez le projet.

  2. Sur la page Sélectionner un langage de programmation, sélectionnez le langage de programmation que vous souhaitez utiliser pour écrire le complément.

  3. Sélectionnez une ou plusieurs applications, telles que Visual Studio, sur la page Sélectionner une application hôte.

    Cela vous permet de choisir les applications dans lesquelles vous voulez pouvoir exécuter le complément après sa création.

  4. Entrez le nom et la description de votre complément sur la page Entrer un nom et une description.

    Notes

    Étant donné qu'un point (« . ») a une signification particulière dans les commandes Visual Studio, Visual Studio ne créera pas de commande par défaut dans le menu  Outils si le nom de votre complément contient un point. 

    Une fois le complément créé, ses nom et description s'affichent dans la liste Compléments disponibles dans le Gestionnaire de compléments. Indiquez suffisamment d'informations dans la description de votre complément afin que les utilisateurs puissent connaître l'utilité de votre complément, son fonctionnement, etc.

  5. Sur la page Choisir les options du complément, vous pouvez définir les paramètres suivants :

    • Si vous voulez que votre complément apparaisse dans le menu Outils.

    • À quel moment vous souhaitez que votre complément démarre.

    • Si votre complément utilise une interface utilisateur (UI) modale ou non. Sinon, il peut être utilisé en toute sécurité avec des générations à partir de la ligne de commande.

  6. Dans la page Choisir les informations contenues dans « À propos de », indiquez si vous voulez que les informations relatives à votre complément apparaissent dans la boîte de dialogue Visual Studio À propos de. Le cas échéant, ajoutez les informations que vous souhaitez afficher.

    Les informations que vous pouvez ajouter dans la boîte de dialogue Visual Studio À propos de incluent notamment le numéro de version, des informations relatives à la prise en charge, des données relatives à la licence, etc.

  7. Après avoir terminé les étapes 1 à 6, les options sélectionnées s'affichent sur la page Résumé pour vérification. Si vous êtes satisfait, cliquez sur Terminer pour créer le complément. Pour effectuer une modification, cliquez sur le bouton Précédent.

    Vous disposez désormais d'un complément de base fonctionnel. Pour que votre complément fonctionne comme vous le souhaitez, vous devez ajouter le code approprié. Pour plus d'informations, consultez Extension de l'environnement Visual Studio.

    Pour comprendre le fonctionnement sous-jacent de l'Assistant Complément, examinez le code qu'il crée.

Sécurité

Les compléments managés sont enregistrés au format .addin, qui correspond à un fichier écrit en XML. L'Assistant Complément intégré à Visual Studio .NET 2002 et Visual Studio .NET 2003 dispose d'une case à cocher qui permet d'enregistrer le complément pour tous les utilisateurs. L'Assistant Complément dans Visual Studio 2005 et les versions ultérieures ne disposent pas cette case à cocher. Pour inscrire un complément managé pour tous les utilisateurs dans Visual Studio 2005 et versions ultérieures, copiez le fichier .addin dans le dossier ..\Documents and Settings\All Users\ folder. Pour enregistrer un complément non managé pour tous les utilisateurs dans Visual Studio 2005 et les versions ultérieures, remplacez HKEY_CURRENT_USER par HKEY_CLASSES_ROOT dans les entrées du Registre appropriées du fichier .reg, puis appliquez le fichier .reg au registre. Pour plus d’informations, consultez Meilleures pratiques pour la sécurité de l'automation et Sécurité des compléments. L'Assistant Complément et les assemblys d'automation ne sont pas disponibles dans les éditions Express de Visual Studio.

Vous n'avez pas besoin d'utiliser de compléments ou d'Assistants pour accéder aux fonctionnalités d'automation. Il vous suffit d'ajouter des références aux assemblys d'automation concernés aux projets Visual Studio et d'accéder à leurs types et membres. Toutefois, l'utilisation de l'automation dans un complément vous permet d'exposer dans l'IDE les outils de compléments que vous créez.

Voir aussi

Tâches

Comment : contrôler des compléments avec le Gestionnaire de compléments

Comment : créer des compléments de solution

Procédure pas à pas : création d'un Assistant

Concepts

Inscription d'un complément

Graphique Modèle d'objet Automation

Autres ressources

Création de compléments et d'Assistants