Udostępnij za pośrednictwem

Samouczek — tworzenie pierwszego rozszerzenia: Hello World

  • Artykuł

Ten przykład Hello World przeprowadzi Cię przez tworzenie pierwszego rozszerzenia dla Visual Studio. W tym samouczku pokazano, jak dodać nowe polecenie do programu Visual Studio.

W tym procesie dowiesz się, jak wykonywać następujące czynności:

W tym przykładzie użyjesz języka Visual C# do dodania niestandardowego przycisku menu o nazwie "Say Hello World!", który wygląda następująco:

Zrzut ekranu przedstawiający polecenie menu niestandardowego.

Warunki wstępne

Przed rozpoczęciem upewnij się, że zainstalowano pakiet roboczy programowania rozszerzeń Visual Studio, który obejmuje szablon VSIX i przykładowy kod.

Notatka

Do utworzenia projektu rozszerzalności programu Visual Studio (Community, Professional lub Enterprise) można użyć dowolnej wersji programu Visual Studio.

Tworzenie projektu rozszerzalności

  1. W menu Plik wybierz pozycję Nowy>Projekt. Wyszukaj ciąg "vsix" i wybierz projekt vsIX w języku C#, a następnie Dalej.

  2. Wprowadź "HelloWorld" dla nazwy projektu i wybierz Utwórz.

Zrzut ekranu przedstawiający tworzenie nowego projektu VSIX.

Teraz powinieneś zobaczyć projekt HelloWorld w Eksploratorze rozwiązań .

Dodawanie polecenia niestandardowego

  1. Jeśli wybierzesz plik manifestu .vsixmanifest, zobaczysz, jakie opcje można zmienić, takie jak opis, autor i wersja.

  2. Kliknij prawym przyciskiem myszy projekt (a nie rozwiązanie). W menu kontekstowym wybierz pozycję Dodaj, a następnie Nowy element.

  3. Wybierz sekcję rozszerzalności, a następnie wybierz polecenie.

  4. W polu nazwa w dolnej części wprowadź nazwę pliku, taką jak Command.cs.

Zrzut ekranu przedstawiający tworzenie polecenia niestandardowego.

Nowy plik polecenia jest widoczny w eksploratorze rozwiązań . W węźle Resources można znaleźć inne pliki powiązane z poleceniem. Jeśli na przykład chcesz zmodyfikować obraz, plik PNG znajduje się tutaj.

Modyfikowanie kodu źródłowego

W tym momencie polecenie i tekst przycisku są generowane automatycznie, a nie tak interesujące. Jeśli chcesz wprowadzić zmiany, możesz zmodyfikować plik VSCT i plik CS.

  • Plik VSCT to miejsce, w którym można zmienić nazwy poleceń i zdefiniować, gdzie przechodzą w systemie poleceń programu Visual Studio. Podczas przeglądania pliku VSCT zwróć uwagę na komentarze, które wyjaśniają, co każda sekcja kodu VSCT kontroluje.

  • Plik CS służy do definiowania akcji, takich jak procedura obsługi kliknięć.

  1. W Eksploratorze rozwiązań znajdź plik VSCT dla rozszerzenia VSPackage. W tym przypadku jest to nazywane HelloWorldPackage.vsct.

  2. Zmień parametr ButtonText 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. Wróć do Eksploratora rozwiązań i znajdź plik Command.cs. W metodzie Execute zmień ciąg 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);
  }
  ...

Pamiętaj, aby zapisać zmiany w każdym pliku.

Uruchom go

Teraz możesz uruchomić kod źródłowy w wystąpieniu eksperymentalnym programu Visual Studio.

Krok 1. Naciśnij F5, aby uruchomić polecenie Rozpocznij debugowanie. To polecenie kompiluje projekt i uruchamia debuger, uruchamiając nowe wystąpienie programu Visual Studio o nazwie Experimental Instance.

Krok 2. W menu NarzędziaExperimental Instancekliknij pozycję Powiedz Witaj Świecie!.

Zrzut ekranu przedstawiający, że polecenie niestandardowe wyświetla pole komunikatu.

Powinny zostać wyświetlone dane wyjściowe z nowego polecenia niestandardowego, w tym przypadku okno dialogowe w środku ekranu, które daje komunikat Hello World!.

Następne kroki

Teraz, gdy znasz już podstawy pracy z rozszerzalnością programu Visual Studio, możesz dowiedzieć się więcej: