Tworzenie rozszerzenia za pomocą polecenia menu

W tym przewodniku pokazano, jak utworzyć rozszerzenie za pomocą polecenia menu uruchamianego w Notatniku.

Utwórz polecenie menu

1. Utwórz projekt VSIX o nazwie FirstMenuCommand. Szablon projektu VSIX można znaleźć w oknie dialogowym Nowy projekt , wyszukując frazę "vsix".

2. Po otwarciu projektu dodaj niestandardowy szablon elementu polecenia o nazwie FirstCommand. W eksploratorze rozwiązań kliknij prawym przyciskiem myszy węzeł projektu i wybierz pozycję Dodaj>nowy element. W oknie dialogowym Dodawanie nowego elementu przejdź do pozycji elementy języka C#>Rozszerzalność i wybierz pozycję Polecenie. W polu Nazwa w dolnej części okna zmień nazwę pliku polecenia na FirstCommand.cs.

3. Skompiluj projekt i rozpocznij debugowanie.

   Zostanie wyświetlone eksperymentalne wystąpienie programu Visual Studio. Aby uzyskać więcej informacji na temat wystąpienia eksperymentalnego, zobacz Wystąpienie eksperymentalne.

4. W wystąpieniu eksperymentalnym otwórz okno Zarządzanie rozszerzeniami>. Tutaj powinno zostać wyświetlone rozszerzenie FirstMenuCommand . (Jeśli otworzysz Zarządzaj rozszerzeniami w wystąpieniu roboczym programu Visual Studio, nie zobaczysz FirstMenuCommand).

Teraz przejdź do menu Narzędzia w wystąpieniu eksperymentalnym. Powinno zostać wyświetlone polecenie Invoke FirstCommand ( Wywołaj polecenie FirstCommand ). W tym momencie polecenie wyświetli pole komunikatu z komunikatem FirstCommand Inside FirstMenuCommand.FirstCommand.MenuItemCallback(). Zobaczymy, jak faktycznie uruchomić Notatnik z tego polecenia w następnej sekcji.

Zmienianie programu obsługi poleceń menu

Teraz zaktualizujmy program obsługi poleceń, aby uruchomić Notatnik.

1. Zatrzymaj debugowanie i wróć do działającego egzemplarza Visual Studio. Otwórz plik FirstCommand.cs i dodaj następującą instrukcję using:

   using System.Diagnostics;
   

2. Znajdź prywatny konstruktor FirstCommand. W tym miejscu polecenie jest przyłączone do usługi poleceń, a program obsługi poleceń jest określony. Zmień nazwę programu obsługi poleceń na StartNotepad w następujący sposób:

   private FirstCommand(AsyncPackage package, OleMenuCommandService commandService)
   {
       this.package = package ?? throw new ArgumentNullException(nameof(package));
       commandService = commandService ?? throw new ArgumentNullException(nameof(commandService));
   
       CommandID menuCommandID = new CommandID(CommandSet, CommandId);
       // Change to StartNotepad handler.
       MenuCommand menuItem = new MenuCommand(this.StartNotepad, menuCommandID);
       commandService.AddCommand(menuItem);
   }
   

3. Usuń metodę Execute i dodaj metodę StartNotepad , która po prostu uruchomi Notatnik:

   private void StartNotepad(object sender, EventArgs e)
   {
       ThreadHelper.ThrowIfNotOnUIThread();
   
       Process proc = new Process();
       proc.StartInfo.FileName = "notepad.exe";
       proc.Start();
   }
   

4. Teraz wypróbuj to. Po rozpoczęciu debugowania projektu i kliknięciu pozycji Narzędzia>Wywołaj pierwszepolecenie powinno zostać wyświetlone wystąpienie Notatnika.

   Możesz użyć wystąpienia Process klasy, aby uruchomić dowolny plik wykonywalny, a nie tylko Notatnik. Wypróbuj to z calc.exe, na przykład.

Czyszczenie środowiska eksperymentalnego

Jeśli tworzysz wiele rozszerzeń lub po prostu eksplorujesz wyniki z różnymi wersjami kodu rozszerzenia, środowisko eksperymentalne może przestać działać tak, jak powinno. W takim przypadku należy uruchomić skrypt resetowania. Nazywa się resetowaniem eksperymentalnej instancji Visual Studio i jest dostarczane jako część Visual Studio SDK. Ten skrypt usuwa wszystkie odwołania do rozszerzeń ze środowiska eksperymentalnego, dzięki czemu można zacząć od podstaw.

Możesz uzyskać dostęp do tego skryptu na jeden z dwóch sposobów:

Wdrażanie rozszerzenia

Teraz, gdy masz rozszerzenie narzędzia uruchomione w żądany sposób, nadszedł czas, aby zastanowić się nad udostępnieniem go znajomym i współpracownikom. Jest to łatwe, o ile mają zainstalowany program Visual Studio 2015. Wszystko, co musisz zrobić, to wysłać do nich skompilowany plik vsix . (Pamiętaj, aby skompilować go w trybie Release).

Plik .vsix dla tego rozszerzenia można znaleźć w katalogu bin FirstMenuCommand. W szczególności, zakładając, że utworzono konfigurację wydania, będzie ona mieć następujące elementy:

<katalog kodów>\FirstMenuCommand\FirstMenuCommand\bin\Release\FirstMenuCommand.vsix

Aby zainstalować rozszerzenie, znajomy musi zamknąć wszystkie otwarte wystąpienia programu Visual Studio, a następnie kliknąć dwukrotnie plik vsix , który wyświetli Instalator VSIX. Pliki są kopiowane do katalogu %LocalAppData%\Microsoft\VisualStudio<version>\Extensions .

Gdy znajomy ponownie uruchomi program Visual Studio, znajdzie rozszerzenie FirstMenuCommand w Narzędziach>Rozszerzenia i aktualizacje. Mogą również przejść do pozycji Rozszerzenia i aktualizacje , aby odinstalować lub wyłączyć rozszerzenie.

Dalsze kroki

W tym przewodniku pokazano tylko niewielką część tego, co można zrobić za pomocą rozszerzenia programu Visual Studio. Oto krótka lista innych (dość łatwych) rzeczy, które można wykonać za pomocą rozszerzeń programu Visual Studio:

1. Wiele innych czynności można wykonać za pomocą prostego polecenia menu:

   1. Dodaj własną ikonę: Dodawanie ikon do poleceń menu

   2. Zmień tekst polecenia menu: Zmień tekst polecenia menu

   3. Dodawanie skrótu menu do polecenia: wiązanie skrótów klawiaturowych z elementami menu

2. Dodaj różne rodzaje poleceń, menu i pasków narzędzi: Rozszerzanie menu i poleceń

3. Dodawanie okien narzędzi i rozszerzanie wbudowanych okien narzędzi programu Visual Studio: rozszerzanie i dostosowywanie okien narzędzi

4. Dodawanie funkcji IntelliSense, sugestii kodu i innych funkcji do istniejących edytorów kodu: rozszerzanie edytora i usług językowych

5. Dodaj opcje i strony właściwości oraz ustawienia użytkownika do rozszerzenia: rozszerzanie właściwości i okna Właściwości oraz rozszerzanie ustawień i opcji użytkownika

   Inne rodzaje rozszerzeń wymagają nieco więcej pracy, takich jak utworzenie nowego typu projektu (rozszerzanie projektów) lub utworzenie nowego typu edytora (tworzenie niestandardowych edytorów i projektantów).