Procédure pas à pas : débogage d'un projet Complément
Cette procédure pas à pas illustre la création d'un projet Complément Visual Studio simple et l'utilisation de points d'arrêt pour déboguer le projet. 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
Les boîtes de dialogue et les commandes de menu qui s'affichent peuvent être différentes de celles qui sont décrites dans l'aide, en fonction de vos paramètres actifs ou de l'édition utilisée. Ces procédures ont été développées avec les paramètres de développement généraux actifs. Pour modifier vos paramètres, choisissez Importation et exportation de paramètres dans le menu Outils. Pour plus d'informations, consultez Utilisation des paramètres.
Pour créer un projet Complément Visual Studio simple
Dans le menu Fichier, pointez sur Nouveau, puis cliquez sur Projet.
La boîte de dialogue New Project Dialog Box apparaît.
Dans le volet Types de projets, développez Autres types de projets, puis sélectionnez Extensibilité.
Dans le volet Modèles, sélectionnez Complément Visual Studio.
Dans le champ Nom, tapez SimpleAddIn comme nom pour votre projet Complément. Cliquez sur OK.
L'Assistant Complément Visual Studio (Welcome to the Add-In Wizard, Visual Studio Add-In Wizard) démarre.
Dans la page Bienvenue dans l'Assistant Complément, cliquez sur Suivant.
Dans la page Sélectionner un langage de programmation, choisissez Créer un complément à l'aide de Visual C# et cliquez sur Suivant.
Dans la page Sélectionner une application hôte, acceptez les options par défaut et cliquez sur Suivant.
Dans la page Entrer un nom et une description, tapez Complément simple comme le nom de votre complément, et tapez Utilisé pour illustrer comment déboguer un Complément simple comme une description de votre complément. Cliquez sur Suivant.
Dans la page Choisir les options du complément, activez l'option Oui, créer un élément dans le menu Outils. Acceptez les paramètres par défaut restants. Cliquez sur Suivant.
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 cliquez sur Suivant.
Dans la page Résumé, cliquez sur Terminer.
L'Assistant Complément génère votre nouveau projet Complément et ouvre l'IDE avec le fichier Connect.cs sélectionné. Il s'agit de la classe principale qui contient le code de votre complément.
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nœud Références, puis cliquez sur Ajouter une référence pour ajouter une référence à votre assembly.
Cela permet l'utilisation de types dans l'espace de noms System.Windows.Forms.
La boîte de dialogue Add Reference Dialog Box apparaît.
Dans l'onglet .NET, double-cliquez sur le composant, System.Windows.Forms.dll.
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 nécessaire pour afficher une boîte de message utilisé dans l'exemple de code suivant.
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;Ajoutez un objet MessageBox à votre complément en ajoutantMessageBox.Show("Debugging a Simple Add-in"); dans la méthode Exec dans Connect.cs:
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; } } }Cliquez sur le bouton Enregistrer tout pour enregistrer votre travail.
Pour déboguer le projet Complément Visual Studio
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 (point d'arrêt) s'affiche et le texte de la ligne est surligné en rouge.
Dans le menu Déboguer, cliquez sur 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.
Dans l'IDE Visual Studio en cours de débogage, cliquez sur le menu Outils.
SimpleAddIn se trouve en haut des éléments de menu.
Sélectionnez la commande SimpleAddIn pour exécuter votre complément.
L'exécution vous amène à la ligne où vous avez défini votre point d'arrêt dans la session du débogueur Visual Studio, surlignée en jaune.
Dans le menu Déboguer de la session du débogueur, cliquez sur Pas à pas détaillé.
Le focus revient au programme en cours de débogage. Votre boîte de message s'ouvre, indiquant que votre complément a été exécuté.
Cliquez sur OK pour fermer la zone de message.
Dans la session du débogueur, dans le menu Déboguer, cliquez sur Continuer.
La session Visual Studio déboguée récupère le focus.
Quittez la session Visual Studio déboguée.
Dans Connect.cs, cliquez sur le point d'arrêt que vous avez défini en regard de l'instruction MessageBox afin de le supprimer du code source.
Comme vous pouvez le voir, lorsque vous déboguez un complément, une autre instance du IDE Visual Studio s'ouvre pour héberger le complément courant. La première instance affiche son code et vous autorise à déboguer, par exemple définir des variables espionnes, des points d'arrêt, etc. Lorsque le débogage est terminé, la deuxième instance de l'IDE se ferme et vous renvoie au code du complément de la première instance.