Partager via


Comment : créer un complément

Mise à jour : novembre 2007

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 de base fonctionnel 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.

Pour en savoir plus sur

Consultez

les différences entre les compléments Visual Studio et les compléments partagés.

Compléments Visual Studio et compléments partagés

Compléments basés sur des solutions.

Comment : créer des compléments de solution

Assistant Complément de Visual Studio

Remarque :

L'Assistant Complément et les assemblys d'automation ne sont pas disponibles dans les éditions Express de Visual Studio.

L'Assistant Complément vous permet de fournir un nom complet et une description de votre complément. Ces deux éléments apparaîtront dans la boîte de dialogue 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é, vous disposez d'un nouveau projet d'une seule classe, nommée Connect, qui implémente le complément.

Remarque :

Les compléments créés dans Visual Studio 2005 ne fonctionnent pas dans Visual Studio .NET 2003. Les compléments créés dans Visual Studio .NET 2003 peuvent ne pas fonctionner correctement dans Visual Studio 2005 sans migration préalable. Pour plus d'informations, consultez Migration et mise à niveau des compléments de Visual Studio 2005 vers Visual Studio 2008.

Utilisez une macro pour accéder à l'automation sans créer de complément. Les macros fournissent un accès rapide et facile aux différents modèles Automation de Visual Studio. Pour plus d'informations, consultez Diversité de l'automation Visual Studio et Automatisation des actions répétitives à l'aide de macros.

Vous n'avez pas besoin d'utiliser de compléments, d'Assistants ou de macros 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 une macro ou un complément vous permet d'exposer dans l'IDE les outils de compléments que vous créez.

Cet exemple montre comment créer un complément de solution.

Remarque :

Selon vos paramètres actifs ou votre édition, les boîtes de dialogue et les commandes de menu que vous voyez peuvent différer de celles qui sont décrites dans l'aide. Ces procédures ont été développées avec les paramètres de développement généraux actifs. Pour modifier vos paramètres, sélectionnez Importation et exportation de paramètres dans le menu Outils. 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 ; par exemple, Visual Studio ou l' éditeur de macros de Visual Studio.

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

    Remarque :

    É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 de la boîte de dialogue Gestionnaire des 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 fenêtre Visual StudioÀ propos de. Le cas échéant, ajoutez les informations que vous souhaitez afficher.

    Les informations que vous pouvez ajouter dans la fenêtre 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 de Visual Studio 2005 et versions ultérieures ne dispose pas de cette case à cocher. Pour enregistrer un complément managé pour tous les utilisateurs dans Visual Studio 2005, copiez le fichier .Addin dans le dossier \Documents and Settings\All Users\. Pour enregistrer un complément non managé pour tous les utilisateurs dans Visual Studio 2005, 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 Méthodes conseillées pour la sécurité de l'automation et Sécurité des compléments.

Voir aussi

Tâches

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

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