Procédure pas à pas : débogage d'un projet Complément

Dans Visual Studio 2013, les compléments sont déconseillés. Nous vous recommandons de mettre vos compléments à niveau aux extensions VSPackage. Pour plus d'informations sur la mise à niveau, consultez FAQ : conversion de compléments en extensions VSPackage.

Cette procédure pas à pas illustre la création d'un projet Complément Visual Studio de base et l'utilisation de points d'arrêt pour le débogage. Pour plus d'informations, consultez Breakpoints and Tracepoints.

Les compléments sont des applications compilées qui utilisent le modèle objet Automation de Visual Studio pour manipuler ou automatiser l'environnement de développement intégré (IDE). Pour plus d'informations, consultez Création de compléments et d'Assistants.

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 projet complément Visual Studio de base

1. Dans la barre de menus, sélectionnez Fichier, Nouveau, Projet.

   La boîte de dialogue New Project Dialog Box apparaît.

2. Dans le volet Types de projets, développez Autres types de projets, puis sélectionnez Extensibilité.

3. Dans le volet Modèles, sélectionnez Complément Visual Studio.

4. Dans le champ Nom, tapez SimpleAddIn. Cliquez sur le bouton OK.

   L'Assistant Complément Visual Studio (Add-in Wizard) démarre.

5. Dans la page Bienvenue dans l'Assistant Complément, cliquez sur le bouton Suivant.

6. Sur la page Sélectionner un langage de programmation, sélectionnez Créer un complément à l'aide de Visual C#, puis Suivant.

7. Sur la page Sélectionner une application hôte, acceptez les options par défaut et choisissez Suivant.

8. Dans la page Entrer un nom et une description, tapez Complément simple en tant que nom et Utilisé pour illustrer comment déboguer un Complément simple en tant que description. Sélectionnez Suivant.

9. Dans la page Choisir les options du complément, sélectionnez l'option Oui, créer un élément dans le menu Outils, acceptez les paramètres par défaut restants, puis choisissez Suivant.

10. Dans la page Choisir les informations contenues dans 'À propos de', activez l'option Oui, je souhaite que mon complément propose une boîte de dialogue 'À propos de' et choisissez Suivant.

11. Dans la page Résumé, choisissez le bouton Terminer.

    L'Assistant Complément génère votre nouveau projet Complément et ouvre le fichier Connect. Il s'agit de la classe principale qui contient le code de votre complément.

12. Dans l'Explorateur de solutions, dans le menu contextuel du projet, choisissez Ajouter, Références, puis choisissez le bouton Ajouter une référence.

    Cela permet l'utilisation de types dans l'espace de noms System.Windows.Forms.

    La boîte de dialogue Add Reference s'affiche.

13. Sous l'onglet .NET, sélectionnez System.Windows.Forms.dll, puis cliquez sur le bouton OK.

    Dans l'Explorateur de solutions, une référence à l'espace de noms System.Windows.Forms s'affiche sous le nœud Références.

    Cet espace de noms contient le code qui est nécessaire pour afficher une boîte de message utilisé dans l'exemple de code suivant.

14. Dans Connect.cs, ajoutez l'instruction suivante vers le début de la portée SimpleAddIn pour faciliter l'utilisation d'un objet MessageBox :

    using System.Windows.Forms;
    

15. Ajoutez un objet MessageBox à votre complément en ajoutant MessageBox.Show("Debugging a Simple Add-in"); à la méthode Exec :

    public void Exec(string commandName,
       vsCommandExecOption executeOption,
       ref object varIn, ref object varOut, ref bool handled)
    {
       handled = false;
       if(executeOption ==
          vsCommandExecOption.vsCommandExecOptionDoDefault)
       {
          if(commandName == "MyAddin1.Connect.MyAddin1")
          {
             handled = true;
             MessageBox.Show("Debugging a Simple Add-in");
             return;
          }
       }
    }
    

16. Choisissez le bouton Enregistrer tout pour enregistrer votre travail.

Pour déboguer le projet Complément Visual Studio

1. Dans Connect.cs, cliquez sur la marge de gauche près de l'instruction suivante :

   MessageBox.Show("Debugging a Simple Add-in")
   

   Un point rouge (qui symbolise un point d'arrêt) s'affiche et le texte de la ligne est surligné en rouge.

2. Dans la barre de menus, sélectionnez Débogage, puis Démarrer le débogage.

   Votre session Visual Studio active (la session du débogueur) perd le focus et le programme en cours de débogage s'ouvre dans une autre instance de Visual Studio.

3. Dans la barre de menus de l'instance de débogage de Visual Studio, choisissez Outils, SimpleAddIn pour exécuter le complément.

   Cela vous permet d'accéder au point d'arrêt que vous avez défini.

4. Dans la barre de menus de l'instance de débogage, choisissez Déboguer, Pas à pas détaillé.

   Le focus revient au programme en cours de débogage. Votre boîte de message s'ouvre et indique que votre complément a été exécuté.

5. Choisissez le bouton OK pour fermer la boîte de message.

6. Dans la barre de menus de l'instance de débogage, choisissez Déboguer, Continuer.

   Fermez l'instance de débogage de Visual Studio.

7. Dans Connect.cs, supprimez le point d'arrêt en regard de l'instruction MessageBox.

Voir aussi

Autres ressources

Création de compléments et d'Assistants

Guide de référence de l'extensibilité et de l'automation