Procédure pas à pas : débogage d'un projet Complément
Mise à jour : novembre 2007
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 Points d'arrêt et points de trace.
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.
.gif "Remarque") Remarque : |
|---|
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 Paramètres Visual Studio. |
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 Nouveau projet, boîte de dialogue 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 (Bienvenue dans l'Assistant Complément, Assistant Complément de Visual Studio) 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 Simple Add-in comme nom pour votre complément et Used to illustrate how to debug a simple Add-in. comme description. 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 Ajouter une référence, boîte de dialogue 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 un 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 ajoutant MessageBox.Show("Debugging a Simple Add-in"); à 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 actuelle (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 de 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 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 constater, lorsque vous déboguez un complément, une autre instance de l'IDE de Visual Studio s'ouvre pour héberger le complément en cours d'exécution. La première instance affiche son code et vous permet de procéder au débogage, par exemple, en définissant 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.