Création de votre première Extension : Hello WorldCreating your First Extension: Hello World

Cet exemple Hello World vous guide tout au long de la création de votre première extension pour Visual Studio.This Hello World example walks you through creating your first extension for Visual Studio. Ce didacticiel vous indiquera comment ajouter une nouvelle commande à Visual Studio.This tutorial will show you how to add a new command to Visual Studio.

Dans le processus, vous allez apprendre comment :In the process, you will learn how to:

Pour cet exemple, vous allez utiliser Visual c# pour ajouter qu'un bouton de menu personnalisé nommé « Par exemple Hello World ! »For this example, you'll use Visual C# to add a custom menu button named "Say Hello World!" qui ressemble à ceci :that looks like this:

commande de Hello world

PrérequisPrerequisites

Avant de commencer, vérifiez que vous avez installé le le développement d’extensions Visual Studio charge de travail qui inclut le modèle VSIX, vous avez besoin et exemple de code.Before you start, make sure you have installed the Visual Studio extension development workload which includes the VSIX template you'll need and sample code.

Remarque : Vous pouvez utiliser n’importe quelle version de Visual Studio (Community, Professional ou Enterprise) pour créer un projet d’extensibilité de Visual Studio.Note: You can use any version of Visual Studio (Community, Professional, or Enterprise) to create a Visual Studio Extensibility project.

Créer un projet d’extensibilitéCreate an extensibility project

Étape 1.Step 1. À partir de la fichier menu, cliquez sur nouveau projet.From the File menu, click New Project. Au bas de l’écran, vous pouvez entrer le nom de votre projet.At the bottom of the screen, you can enter the name of your project.

Étape 2.Step 2. À partir de la modèles menu, cliquez sur Visual C#, cliquez sur extensibilité, puis cliquez sur projet VSIX.From the Templates menu, click Visual C#, click Extensibility, and then click VSIX Project.

nouveau projet

Vous devez maintenant voir la page mise en route et quelques exemples de ressources.You should now see the Getting Started page and some sample resources.

Si vous devez laisser ce didacticiel et revenir à ce dernier, vous pouvez trouver votre nouveau projet HelloWorld sur le Page de démarrage dans les récents section.If you need to leave this tutorial and come back to it, you can find your new HelloWorld project on the Start Page in the Recent section.

Ajouter une commande personnaliséeAdd a custom command

Étape 1.Step 1. Si vous sélectionnez le manifeste, vous pouvez voir quelles options sont modifiables, pour l’instance de métadonnées, de désignation et de version.If you select the manifest, you can see what options are changeable, for instance, metadata, description, and version.

Étape 2.Step 2. Cliquez sur le projet (pas la solution).Right-click the project (not the solution). Dans le menu contextuel, cliquez sur ajouter, puis cliquez sur contrôle utilisateur.On the context menu, click Add, and then click User Control.

Étape 3.Step 3. Revenez à la extensibilité section, puis cliquez sur commande personnalisée.Go back to the Extensibility section, and then click Custom Command.

Étape 4.Step 4. Dans le nom champ en bas, attribuez-lui un nom, par exemple Command.cs.In the Name field at the bottom, give it a name, for instance Command.cs.

commande personnalisée

Votre nouvelle commande est répertorié dans le l’Explorateur de solutions sous le ressources branche.Your new command will be listed in the Solution Explorer under the Resources branch. Il s’agit également où vous trouverez les autres fichiers associés à votre commande, tels que les fichiers PNG et ICO si vous souhaitez modifier l’image.This is also where you'll find other files related to your command, such as the PNG and ICO files if you wish to modify the image.

Modifier le code sourceModify the source code

À ce stade, le bouton que vous ajoutez est relativement générique.At this point, the Button you're adding is pretty generic. Vous devrez modifier le fichier VSCT et le fichier CS, si vous souhaitez apporter des modifications.You'll have to modify the VSCT file and CS file if you want to make changes.

  • Le fichier VSCT est où vous pouvez renommer vos commandes, ainsi que définir où elles sont placées dans le système de commande de Visual Studio.The VSCT file is where you can rename your commands, as well as define where they go in the Visual Studio command system. Pendant que vous explorez le fichier VSCT, vous pouvez remarquer un grand nombre des commentaires de code qui explique le contenu de chaque section des contrôles de code.As you explore the VSCT file, you will notice a lot of commented code that explains what each section of code controls.

  • Le fichier CS est où vous pouvez définir des actions, telles que l’événements Click.The CS file is where you can define actions, such as the click handler.

Étape 1.Step 1. Dans l’Explorateur de solutions, recherchez le fichier VSCT pour votre nouvelle commande.In Solution Explorer, find the VSCT file for your new command. Dans ce cas, elle sera appelée CommandPackage.vsct.In this case, it will be called CommandPackage.vsct.

commande package vsct

Étape 2.Step 2. Modifier la ButtonText paramètre « Dire Hello World ! »Change the ButtonText parameter to "Say Hello World!"

  ...
  <Button guid="guidCommandPackageCmdSet" id="CommandId" priority="0x0100" type="Button">
     <Parent guid="guidCommandPackageCmdSet" id="MyMenuGroup" />
     <Icon guid="guidImages" id="bmpPic1" />
     <Strings>
        <ButtonText>Say Hello World!</ButtonText>
     </Strings>
  </Button>
  ...

Étape 3.Step 3. Revenez à l’Explorateur de solutions et recherchez le fichier Command.cs.Go back to Solution Explorer and find the Command.cs file. Modifier la chaîne de message pour la commande string.Format(..) à « Hello World ! »Change the string message for the command string.Format(..) to "Hello World!"

  ...
  private void MenuItemCallback(object sender, EventArgs e)
  {
    string message = "Hello World!";
    string title = "Command1";

    // Show a message box to prove we were here
    VsShellUtilities.ShowMessageBox(
        this.ServiceProvider,
        message,
        title,
        OLEMSGICON.OLEMSGICON_INFO,
        OLEMSGBUTTON.OLEMSGBUTTON_OK,
        OLEMSGDEFBUTTON.OLEMSGDEFBUTTON_FIRST);
  }
  ...

Veillez à enregistrer vos modifications dans chaque fichier.Make sure to save your changes to each file.

ExécuterRun it

Vous pouvez maintenant exécuter le code source dans l’Instance expérimentale de Visual Studio.You can now run the source code in the Visual Studio Experimental Instance.

Étape 1.Step 1. Cliquez sur Démarrer dans la barre d’outils.Click Start in the Toolbar. Cela génère votre projet et démarrer le débogueur, lancer une nouvelle instance de Visual Studio appelé le Instance expérimentale.This will build your project and start the debugger, launching a new instance of Visual Studio called the Experimental Instance.

Vous verrez les mots « Instance expérimentale » dans la barre de titre de Visual Studio.You will see the words "Experimental Instance" in the Visual Studio title bar.

barre de titre d’instance expérimentale

Étape 2.Step 2. Sur le outils menu de la Instance expérimentale, cliquez sur Say Hello World !.On the Tools menu of the Experimental Instance, click Say Hello World!.

résultat final

Vous devez voir la sortie à partir de votre nouvelle commande personnalisée, dans ce cas la boîte de dialogue dans le centre de l’écran qui vous donne « Hello World ! »You should see the output from your new custom command, in this case the dialog in the center of the screen that gives you the "Hello World!" « Operation Not Found! ».message.

Étapes suivantesNext steps

Maintenant que vous connaissez les principes fondamentaux de l’utilisation de l’extensibilité de Visual Studio, voici où vous pouvez en savoir plus :Now that you know the basics of working with Visual Studio Extensibility, here's where you can learn more: