Condividi tramite

Esercitazione: Creare la prima estensione: Hello World

  • Articolo

Questo esempio Hello World illustra come creare la prima estensione per Visual Studio. Questa esercitazione illustra come aggiungere un nuovo comando a Visual Studio.

Nel processo si apprenderà come:

Per questo esempio, si usa Visual C# per aggiungere un pulsante di menu personalizzato denominato "Say Hello World!" simile al seguente:

Screenshot che mostra un comando di menu personalizzato.

Prerequisiti

Prima di iniziare, assicurarsi di aver installato il workload di sviluppo di estensioni di Visual Studio , che include il modello VSIX e il codice di esempio.

Nota

È possibile usare qualsiasi edizione di Visual Studio (Community, Professional o Enterprise) per creare un progetto di estendibilità di Visual Studio.

Creare un progetto di estendibilità

  1. Dal menu File di, selezionare Nuovo >Progetto. Cercare "vsix" e selezionare il progetto VSIX C# e quindi Avanti.

  2. Inserire "HelloWorld" come nome del progetto e selezionare Crea.

Screenshot che mostra la creazione di un nuovo progetto VSIX.

Verrà ora visualizzato il progetto HelloWorld in Esplora soluzioni .

Aggiungere un comando personalizzato

  1. Se si seleziona il file manifesto .vsixmanifest, è possibile visualizzare le opzioni modificabili, ad esempio descrizione, autore e versione.

  2. Fare clic con il pulsante destro del mouse sul progetto (non sulla soluzione). Nel menu di scelta rapida selezionare Aggiungie quindi Nuovo elemento.

  3. Selezionare la sezione estendibilità e quindi scegliere Comando.

  4. Nel campo Nome nella parte inferiore immettere un nome file, ad esempio Command.cs.

Screenshot che mostra la creazione di un comando personalizzato.

Il nuovo file di comando è visibile in Esplora soluzioni . Nel nodo Risorse è possibile trovare altri file correlati al comando. Ad esempio, se vuoi modificare l'immagine, il file PNG è qui.

Modificare il codice sorgente

A questo punto, il testo del comando e del pulsante vengono generati automaticamente e non sono interessanti. Se si desidera apportare modifiche, è possibile modificare il file VSCT e il file CS.

  • Il file VSCT è il percorso in cui è possibile rinominare i comandi e definire dove si trovano nel sistema di comandi di Visual Studio. Durante l'esplorazione del file VSCT, notare i commenti che spiegano quale sezione del codice VSCT controlla ciascun elemento.

  • Il file CS è dove puoi definire azioni, come il gestore del clic.

  1. In Esplora soluzioni, trova il file VSCT per l'estensione VSPackage. In questo caso, viene chiamato HelloWorldPackage.vsct.

  2. Modificare il parametro ButtonText in 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. Torna a Esplora Soluzioni e trova il file Command.cs. Nel metodo Execute modificare la stringa message da string.Format(..) a 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);
  }
  ...

Assicurarsi di salvare le modifiche apportate a ogni file.

Esegui

È ora possibile eseguire il codice sorgente nell'istanza sperimentale di Visual Studio.

Passaggio 1. Premere F5 per eseguire il comando Avvia debug. Questo comando compila il progetto e avvia il debugger, avviando una nuova istanza di Visual Studio denominata Istanza sperimentale.

Passaggio 2. Nel menu Strumenti dell'istanza sperimentale fare clic su Saluta il mondo!.

Screenshot che mostra che il comando personalizzato visualizza una finestra di messaggio.

Dovresti vedere l'output del tuo nuovo comando personalizzato, in questo caso, la finestra di dialogo al centro della schermata che mostra il messaggio Hello World!.

Passaggi successivi

Ora che si conoscono le nozioni di base sull'uso dell'estendibilità di Visual Studio, ecco dove è possibile ottenere altre informazioni: