Créer votre première extension : Hello WorldCreate your first extension: Hello World

Cet exemple Hello World vous explique comment créer votre première extension pour Visual Studio.This Hello World example walks you through creating your first extension for Visual Studio. Ce didacticiel vous explique 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 utiliserez Visual c# pour ajouter qu'un bouton de menu personnalisé nommé « Dire 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, assurez-vous que vous avez installé 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. En 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 certains 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 le 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 sont les options modifiables, pour l’instance, métadonnées, la description et 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 du bas, donnez-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 s’afficheront 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, telles 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 définir où ils vont 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. À mesure que vous explorez le fichier VSCT, vous remarquerez un grand nombre de commentaires de code qui explique le contenu de chaque section de 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 dans laquelle vous pouvez définir des actions, telles que le Gestionnaire de clic.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 le ButtonText paramètre Say 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 Command.cs fichier.Go back to Solution Explorer and find the Command.cs file. Modifier la chaîne 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écutez-leRun 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 devriez voir la sortie de votre nouvelle commande personnalisée, dans ce cas, la boîte de dialogue dans le centre de l’écran qui vous donne le 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: