Skapa ett tillägg med ett menykommando

Den här genomgången visar hur du skapar ett tillägg med ett menykommando som startar Anteckningar.

Skapa ett menykommando

1. Skapa ett VSIX-projekt med namnet FirstMenuCommand. Du hittar VSIX-projektmallen i dialogrutan Nytt projekt genom att söka efter "vsix".

2. När projektet öppnas lägger du till en anpassad kommandoobjektmall med namnet FirstCommand. Högerklicka på projektnoden i Solution Exploreroch välj Lägg till>nytt objekt. I dialogrutan Lägg till nytt objekt går du till C#-objekt>Utökningsbarhet och väljer Kommando. I fältet Namn längst ned i fönstret ändrar du kommandofilnamnet till FirstCommand.cs.

3. Skapa projektet och börja felsöka.

   Den experimentella instansen av Visual Studio visas. Mer information om den experimentella instansen finns i Den experimentella instansen.

4. I den experimentella instansen öppnar du fönstret Tillägg>Hantera tillägg. Du bör se tillägget FirstMenuCommand här. (Om du öppnar Hantera tillägg i din arbetsinstans av Visual Studio visas inte FirstMenuCommand).

Gå nu till menyn Verktyg i den experimentella instansen. Du bör se kommandot Anropa FirstCommand. Vid denna punkt visas en meddelanderuta med texten FirstCommand Inside FirstMenuCommand.FirstCommand.MenuItemCallback(). Vi ska se hur du faktiskt startar Anteckningsblock från det här kommandot i nästa avsnitt.

Ändra menykommandohanteraren

Nu ska vi uppdatera kommandohanteraren för att starta Anteckningar.

1. Sluta felsöka och gå tillbaka till din arbetsinstans av Visual Studio. Öppna filen FirstCommand.cs och lägg till följande med hjälp av -instruktionen:

   using System.Diagnostics;
   

2. Hitta den privata FirstCommand-konstruktorn. Det är här kommandot är anslutet till kommandotjänsten och kommandohanteraren har angetts. Ändra namnet på kommandohanteraren till StartNotepad på följande sätt:

   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. Ta bort metoden Execute och lägg till en StartNotepad-metod, som bara startar Anteckningar:

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

4. Testa det nu. När du börjar felsöka projektet och klickar med musen på Tools>Invoke FirstCommandbör du se en instans av Anteckningar.

   Du kan använda en instans av klassen Process för att köra alla körbara filer, inte bara Anteckningar. Prova med calc.exe, till exempel.

Rensa den experimentella miljön

Om du utvecklar flera tillägg, eller bara utforskar resultat med olika versioner av tilläggskoden, kan din experimentella miljö sluta fungera som den ska. I det här fallet bör du köra återställningsskriptet. Den heter Reset the Visual Studio Experimental Instanceoch levereras som en del av Visual Studio SDK. Det här skriptet tar bort alla referenser till dina tillägg från den experimentella miljön, så att du kan börja från början.

Du kan komma åt det här skriptet på något av två sätt:

1. Från skrivbordet hittar du Återställ Visual Studio Experimental Instance.

2. Kör följande från kommandoraden:

   <VSSDK installation>\VisualStudioIntegration\Tools\Bin\CreateExpInstance.exe /Reset /VSInstance=<version> /RootSuffix=Exp && PAUSE
   
   

Distribuera ditt tillägg

Nu när du har fått verktygstillägget att fungera som du vill är det dags att tänka på att dela det med dina vänner och kollegor. Det är enkelt, så länge de har Visual Studio 2015 installerat. Allt du behöver göra är att skicka dem .vsix- fil som du har skapat. (Kom ihåg att skapa det i release-läge.)

Du hittar filen .vsix för det här tillägget i katalogen FirstMenuCommand bin. Mer specifikt, förutsatt att du har skapat versionskonfigurationen, kommer den att finnas i:

<kodkatalogen>\FirstMenuCommand\FirstMenuCommand\bin\Release\FirstMenuCommand.vsix

Om du vill installera tillägget måste din vän stänga alla öppna instanser av Visual Studio och sedan dubbelklicka på filen .vsix, som tar upp VSIX Installer. Filerna kopieras till %LocalAppData%\Microsoft\VisualStudio<version>\Extensions-katalogen.

När din vän tar upp Visual Studio igen hittar de FirstMenuCommand-tillägget i Tools>Extensions and Updates. De kan gå till tillägg och uppdateringar för att avinstallera eller inaktivera tillägget också.

Nästa steg

Den här genomgången visar bara en liten del av vad du kan göra med ett Visual Studio-tillägg. Här är en kort lista över andra (ganska enkla) saker du kan göra med Visual Studio-tillägg:

1. Du kan göra många fler saker med ett enkelt menykommando:

   1. Lägg till en egen ikon: Lägg till ikoner i menykommandon

   2. Ändra texten i menykommandot: Ändra texten i ett menykommando

   3. Lägg till en menygenväg till ett kommando: Binda kortkommandon till menyalternativ

2. Lägg till olika typer av kommandon, menyer och verktygsfält: Utöka menyer och kommandon

3. Lägg till verktygsfönster och utöka de inbyggda Visual Studio-verktygsfönstren: Utöka och anpassa verktygsfönster

4. Lägg till IntelliSense, kodförslag och andra funktioner i befintliga kodredigerare: Utöka redigerings- och språktjänster

5. Lägg till alternativ och egenskapssidor och användarinställningar i tillägget: Utöka egenskaper och egenskapsfönstret och Utöka användarinställningar och alternativ

   Andra typer av tillägg kräver lite mer arbete, till exempel att skapa en ny typ av projekt (Utöka projekt), eller att skapa en ny typ av redigerare (Skapa anpassade redigerare och designers).