Kurz – Vytvoření prvního rozšíření: Hello World

  • Článek

Tento příklad Hello World vás provede vytvořením prvního rozšíření pro Visual Studio. V tomto kurzu se dozvíte, jak do sady Visual Studio přidat nový příkaz.

V procesu se naučíte:

V tomto příkladu použijete Visual C# k přidání vlastního tlačítka nabídky s názvem "Say Hello World!", které vypadá takto:

Screenshot showing a custom menu command.

Poznámka:

Tento článek se týká sady Visual Studio ve Windows. Informace o Visual Studio pro Mac najdete v průvodci rozšiřitelností v Visual Studio pro Mac.

Požadavky

Než začnete, ujistěte se, že jste nainstalovali úlohu vývoje rozšíření sady Visual Studio, která obsahuje šablonu VSIX a ukázkový kód.

Poznámka:

K vytvoření projektu rozšiřitelnosti sady Visual Studio můžete použít libovolnou edici sady Visual Studio (Community, Professional nebo Enterprise).

Vytvoření projektu rozšiřitelnosti

  1. V nabídce Soubor vyberte Nový>projekt. Vyhledejte "vsix" a vyberte projekt VSIX jazyka C# a pak další.

  2. Jako název projektu zadejte "HelloWorld" a vyberte Vytvořit.

Screenshot showing creating a new VSIX project.

Teď byste měli vidět projekt HelloWorld v Průzkumník řešení.

Přidání vlastního příkazu

  1. Pokud vyberete soubor manifestu .vsixmanifest , uvidíte, jaké možnosti se dají změnit, například popis, autor a verze.

  2. Klikněte pravým tlačítkem myši na projekt (ne na řešení). V místní nabídce vyberte Přidat a potom Novou položku.

  3. Vyberte oddíl Rozšiřitelnost a pak zvolte Příkaz.

  4. Do pole Název v dolní části zadejte název souboru, například Command.cs.

Screenshot showing creating a custom command.

Nový soubor příkazu se zobrazí v Průzkumník řešení. V uzlu Prostředky můžete najít další soubory související s vaším příkazem. Pokud například chcete upravit obrázek, soubor PNG je tady.

Úprava zdrojového kódu

V tomto okamžiku se text příkazu a tlačítka automaticky vygeneruje a není to zajímavé. Pokud chcete provést změny, můžete upravit soubor VSCT a soubor CS.

  • Soubor VSCT je místo, kde můžete přejmenovat příkazy a definovat, kam v příkazovém systému sady Visual Studio přejdou. Při zkoumání souboru VSCT si všimněte komentářů, které vysvětlují, jaké části ovládacích prvků kódu VSCT.

  • Soubor CS je místo, kde můžete definovat akce, jako je obslužná rutina kliknutí.

  1. V Průzkumník řešení vyhledejte soubor VSCT pro vaši příponu VSPackage. V tomto případě se nazývá HelloWorldPackage.vsct.

  2. ButtonText Změňte parametr na 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. Vraťte se do Průzkumník řešení a vyhledejte soubor Command.cs. Execute V metodě změňte řetězec message z string.Format(..) na 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);
  }
  ...

Nezapomeňte změny uložit do každého souboru.

Spusťte skript.

Zdrojový kód teď můžete spustit v experimentální instanci sady Visual Studio.

Krok 1. Stisknutím klávesy F5 spusťte příkaz Spustit ladění . Tento příkaz sestaví projekt a spustí ladicí program a spustí novou instanci sady Visual Studio s názvem Experimentální instance.

Krok 2. V nabídce Nástroje experimentální instance klepněte na tlačítko Řekněte Hello World!.

Screenshot showing that the custom command displays a message box.

Měli byste vidět výstup z nového vlastního příkazu, v tomto případě dialogové okno uprostřed obrazovky, ve které se zobrazí zpráva Hello World! .

Další kroky

Teď, když znáte základy práce s rozšiřitelností sady Visual Studio, získáte další informace: