Dela via

Genomgång: Skapa ditt första VSTO-tillägg för Excel

Den här introduktionsgenomgången visar hur du skapar ett tillägg på programnivå för Microsoft Office Excel. De funktioner som du skapar i den här typen av lösning är tillgängliga för själva programmet, oavsett vilka arbetsböcker som är öppna.

Gäller för: Informationen i det här avsnittet gäller för VSTO-tilläggsprojekt för Excel. Mer information finns i Funktioner som är tillgängliga efter Office-program och projekttyp.

Anmärkning

Vill du utveckla lösningar som utökar Office-upplevelsen på flera plattformar? Kolla in den nya Office-tilläggsmodellen. Office-tillägg har ett litet fotavtryck jämfört med VSTO-tillägg och lösningar, och du kan skapa dem med hjälp av nästan alla webbprogrammeringsteknik, till exempel HTML5, JavaScript, CSS3 och XML.

I den här genomgången tas följande aktiviteter upp:

  • Skapa ett Excel VSTO-tilläggsprojekt för Excel.

  • Skriva kod som använder objektmodellen i Excel för att lägga till text i en arbetsbok när den sparas.

  • Skapa och köra projektet för att testa det.

  • Rensa det slutförda projektet så att VSTO-tillägget inte längre körs automatiskt på utvecklingsdatorn.

    Anmärkning

    Datorn kan visa olika namn eller platser för vissa av Visual Studio-användargränssnittselementen i följande instruktioner. Den Visual Studio-utgåva som du har och de inställningar som du använder avgör dessa element. Mer information finns i Anpassa IDE.

Förutsättningar

Du behöver följande komponenter för att slutföra den här genomgången:

Skapa projektet

Skapa ett nytt Excel VSTO-tilläggsprojekt i Visual Studio

  1. Starta Visual Studio.

  2. Peka på Nytt på Arkiv-menyn och klicka sedan på Projekt.

  3. I fönstret Mallar expanderar du Visual C# eller Visual Basic och expanderar sedan Office/SharePoint.

  4. Under den expanderade Noden Office/SharePoint väljer du noden Office-tillägg .

  5. I listan över projektmallar väljer du Excel 2010-tillägg eller Excel 2013-tillägg.

  6. I rutan Namn skriver du FirstExcelAddIn.

  7. Klicka på OK.

    Visual Studio skapar Projektet FirstExcelAddIn och öppnar kodfilen ThisAddIn i redigeraren.

Skriva kod för att lägga till text i den sparade arbetsboken

Lägg sedan till kod i kodfilen ThisAddIn. Den nya koden använder objektmodellen i Excel för att infoga standardtext i den första raden i det aktiva kalkylbladet. Det aktiva kalkylbladet är det kalkylblad som är öppet när användaren sparar arbetsboken. Kodfilen ThisAddIn innehåller som standard följande genererade kod:

  • En partiell definition av ThisAddIn klassen. Den här klassen tillhandahåller en startpunkt för koden och ger åtkomst till objektmodellen i Excel. Mer information finns i Program VSTO-tillägg. Resten av ThisAddIn klassen definieras i en dold kodfil som du inte bör ändra.

  • Händelsehanterarna ThisAddIn_Startup och ThisAddIn_Shutdown . Dessa händelsehanterare anropas när Excel läser in och tar bort ditt VSTO-tillägg. Använd dessa händelsehanterare för att initiera DITT VSTO-tillägg när det läses in och för att rensa resurser som används av tillägget när det tas bort. Mer information finns i Händelser i Office-projekt.

Så här lägger du till en textrad i den sparade arbetsboken

  1. I kodfilen ThisAddIn lägger du till följande kod i ThisAddIn klassen. Den nya koden definierar en händelsehanterare för WorkbookBeforeSave händelsen, som aktiveras när en arbetsbok sparas.

    När användaren sparar en arbetsbok lägger händelsehanteraren till ny text i början av det aktiva kalkylbladet.

    void Application_WorkbookBeforeSave(Microsoft.Office.Interop.Excel.Workbook Wb, bool SaveAsUI, ref bool Cancel)
{
    Excel.Worksheet activeWorksheet = ((Excel.Worksheet)Application.ActiveSheet);
    Excel.Range firstRow = activeWorksheet.get_Range("A1");
    firstRow.EntireRow.Insert(Excel.XlInsertShiftDirection.xlShiftDown);
    Excel.Range newFirstRow = activeWorksheet.get_Range("A1");
    newFirstRow.Value2 = "This text was added by using code";
}

  2. Om du använder C# lägger du till följande kod som krävs i ThisAddIn_Startup händelsehanteraren. Den här koden används för att ansluta Application_WorkbookBeforeSave händelsehanteraren till WorkbookBeforeSave händelsen.

    this.Application.WorkbookBeforeSave += new Microsoft.Office.Interop.Excel.AppEvents_WorkbookBeforeSaveEventHandler(Application_WorkbookBeforeSave);

    Om du vill ändra arbetsboken när den sparas använder de föregående kodexemplen följande objekt:

  • Fältet Application för ThisAddIn klassen. Fältet Application returnerar ett Application objekt som representerar den aktuella instansen av Excel.

  • Parametern Wb för händelsehanteraren för WorkbookBeforeSave händelsen. Parametern Wb är ett Workbook objekt som representerar den sparade arbetsboken. Mer information finns i Översikt över Excel-objektmodell.

Testa projektet

Så här testar du projektet

  1. Tryck på F5 för att skapa och köra projektet.

    När du skapar projektet kompileras koden till en sammansättning som ingår i utdatamappen för projektet. Visual Studio skapar också en uppsättning registerposter som gör det möjligt för Excel att identifiera och läsa in VSTO-tillägget, och konfigurerar säkerhetsinställningarna på utvecklingsdatorn så att VSTO-tillägget kan köras. Mer information finns i Skapa Office-lösningar.

  2. Spara arbetsboken i Excel.

  3. Kontrollera att följande text har lagts till i arbetsboken.

    Den här texten har lagts till med hjälp av kod.

  4. Stäng Excel.

Rensa projektet

När du har utvecklat ett projekt tar du bort VSTO-tilläggssammansättningen, registerposterna och säkerhetsinställningarna från utvecklingsdatorn. Annars fortsätter VSTO-tillägget att köras varje gång du öppnar Excel på utvecklingsdatorn.

Så här rensar du det slutförda projektet på utvecklingsdatorn

  1. I Visual Studio går du till menyn Skapa och klickar på Rensa lösning.

Nästa steg

Nu när du har skapat ett grundläggande VSTO-tillägg för Excel kan du lära dig mer om hur du utvecklar VSTO-tillägg från följande ämnen:

Relaterat innehåll