Partager via

Tutoriel - Créer votre première extension : Hello World

Cet exemple Hello World vous guide tout au long de la création de votre première extension pour Visual Studio. Ce tutoriel vous montre comment ajouter une nouvelle commande à Visual Studio.

Dans le processus, vous allez apprendre à :

Pour cet exemple, vous utilisez Visual C# pour ajouter un bouton de menu personnalisé nommé « Say Hello World ! » qui ressemble à ceci :

Capture d’écran montrant une commande de menu personnalisée.

Conditions préalables

Avant de commencer, vérifiez que vous avez installé la charge de travail de développement d’extension Visual Studio, qui inclut le modèle VSIX et l’exemple de code.

Note

Vous pouvez utiliser n’importe quelle édition de Visual Studio (Community, Professional ou Enterprise) pour créer un projet d’extensibilité Visual Studio.

Créer un projet d’extensibilité

  1. Dans le menu Fichier, sélectionnez Nouveau>Projet. Recherchez « vsix », puis sélectionnez le projet VSIX C#, puis suivant.

  2. Entrez « HelloWorld » pour le nom du projet , puis sélectionnez Créer.

Capture d’écran montrant la création d’un projet VSIX.

Vous devez maintenant voir le projet HelloWorld dans l’Explorateur de solutions.

Ajouter une commande personnalisée

  1. Si vous sélectionnez le fichier manifeste .vsixmanifest, vous pouvez voir quelles options sont modifiables, telles que la description, l’auteur et la version.

  2. Cliquez avec le bouton droit sur le projet (et non sur la solution). Dans le menu contextuel, sélectionnez Ajouter, puis Nouvel élément.

  3. Sélectionnez la section Extensibilité, puis choisissez Commande.

  4. Dans le champ Nom en bas, entrez un nom de fichier tel que Command.cs.

Capture d’écran montrant la création d’une commande personnalisée.

Votre nouveau fichier de commandes est visible dans Explorateur de solutions. Sous le nœud Ressources, vous trouverez d’autres fichiers liés à votre commande. Par exemple, si vous souhaitez modifier l’image, le fichier PNG est ici.

Modifier le code source

À ce stade, la commande et le texte du bouton sont générés automatiquement et non pas aussi intéressants. Vous pouvez modifier le fichier VSCT et le fichier CS si vous souhaitez apporter des modifications.

  • Le fichier VSCT est l’endroit où vous pouvez renommer vos commandes et définir l’emplacement où elles se trouvent dans le système de commandes Visual Studio. Lorsque vous explorez le fichier VSCT, notez les commentaires qui expliquent ce que contrôle chaque section du code VSCT.

  • Le fichier CS est l’endroit où vous pouvez définir des actions, telles que le gestionnaire de clics.

  1. Dans Explorateur de solutions, recherchez le fichier VSCT de votre extension VSPackage. Dans ce cas, elle est appelée HelloWorldPackage.vsct.

  2. Remplacez le paramètre ButtonText par 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>
  ...

  3. Revenez au de l’Explorateur de solutions et recherchez le fichier Command.cs. Dans la méthode Execute, remplacez la chaîne message de string.Format(..) par Hello World!.

      ...
  private void Execute(object sender, EventArgs e)
  {
    ThreadHelper.ThrowIfNotOnUIThread();
    string message = "Hello World!";
    string title = "Command";

    // 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.

L’exécuter

Vous pouvez maintenant exécuter le code source dans l’instance expérimentale de Visual Studio.

Étape 1. Appuyez sur F5 pour exécuter la commande Démarrer le débogage. Cette commande génère votre projet et démarre le débogueur, en lançant une nouvelle instance de Visual Studio appelée instance expérimentale.

Étape 2. Dans le menu Outils de l'instance expérimentale , cliquez sur Dire Bonjour tout le monde !.

Capture d’écran montrant que la commande personnalisée affiche une boîte de message.

Vous devriez voir la sortie de votre nouvelle commande personnalisée, dans ce cas, la boîte de dialogue au centre de l'écran qui vous donne le message Bonjour tout le monde !.

Étapes suivantes

Maintenant que vous connaissez les principes de base de l’utilisation de Visual Studio Extensibilité, voici où vous pouvez en savoir plus :