Dela via

Genomgång: Skapa din första anpassning på dokumentnivå för Excel

Den här introduktionsgenomgången visar hur du skapar en anpassning på dokumentnivå för Microsoft Office Excel. De funktioner som du skapar i den här typen av lösning är endast tillgängliga när en specifik arbetsbok är öppen. Du kan inte använda en anpassning på dokumentnivå för att göra programomfattande ändringar, till exempel genom att visa en ny menyflik när en arbetsbok är öppen.

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

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

  • Skapa ett Excel-arbetsboksprojekt.

  • Lägga till text i ett kalkylblad som finns i Visual Studio-designern.

  • Skriva kod som använder objektmodellen i Excel för att lägga till text i det anpassade kalkylbladet när det öppnas.

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

  • Rensa det slutförda projektet för att ta bort onödiga byggfiler och säkerhetsinställningar från 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-arbetsboksprojekt i Visual Studio

  1. Starta Visual Studio.

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

  3. I dialogrutan Skapa ett nytt projekt väljer du projektet Excel VSTO-arbetsbok .

    Anmärkning

    Du kan också söka efter mallar genom att skriva namnet på Office-produkten i textrutan Sök överst i dialogrutan Skapa ett nytt projekt . Om du till exempel skriver Excel visas alla projektmallar för Excel. Du kan också filtrera listan med mallar så att endast mallarna för Office visas genom att välja Office i listrutan Projekttyp. Mer information finns i Skapa ett nytt projekt i Visual Studio.

  4. Klicka på Nästa.

  5. Skriv FirstWorkbookCustomization i rutan Namn i dialogrutan Konfigurera det nya projektet och klicka på Skapa.

  6. Välj Skapa ett nytt dokument i visual studioverktyg för Office-projektguiden och klicka på OK.

    • Visual Studio skapar projektet FirstWorkbookCustomization och lägger till följande filer i projektet.

    • FirstWorkbookCustomization.xlsx – Representerar Excel-arbetsboken i projektet. Innehåller alla kalkylblad och diagram.

    • Blad1 (.vb fil för Visual Basic eller .cs fil för Visual C#) – Ett kalkylblad som innehåller designytan och koden för det första kalkylbladet i arbetsboken. Mer information finns i Kalkylbladsvärdobjekt.

    • Sheet2 (.vb fil för Visual Basic eller .cs fil för Visual C#) – ett kalkylblad som innehåller designytan och koden för det andra kalkylbladet i arbetsboken.

    • Blad3 (.vb fil för Visual Basic eller .cs fil för Visual C#) – Ett kalkylblad som innehåller designytan och koden för det tredje kalkylbladet i arbetsboken.

    • ThisWorkbook (.vb-fil för Visual Basic eller .cs fil för Visual C#) – Innehåller designytan och koden för anpassningar på arbetsboksnivå. Mer information finns i Arbetsboksvärdobjekt.

      Blad1-kodfilen öppnas automatiskt i designern.

Stäng och öppna kalkylblad i designern igen

Om du avsiktligt eller av misstag stänger en arbetsbok eller ett kalkylblad i designern när du utvecklar projektet kan du öppna det igen.

Stänga och öppna ett kalkylblad igen i designern

  1. Stäng arbetsboken genom att klicka på knappen Stäng (X) för designerfönstret.

  2. Högerklicka på blad1-kodfilen i Solution Explorer och klicka på Visa designer.

    -eller-

    Dubbelklicka på blad1-kodfilen i Solution Explorer.

Lägga till text i ett kalkylblad i designern

Du kan utforma användargränssnittet (UI) för din anpassning genom att ändra kalkylbladet som är öppet i designern. Du kan till exempel lägga till text i celler, använda formler eller lägga till Excel-kontroller. Mer information om hur du använder designern finns i Office-projekt i Visual Studio-miljön.

Så här lägger du till text i ett kalkylblad med hjälp av designern

  1. I kalkylbladet som är öppet i designern väljer du cell A1 och skriver sedan följande text.

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

Varning

Om du lägger till den här textraden i cell A2 skrivs den över av annan kod i det här exemplet.

Lägga till text i ett kalkylblad programmatiskt

Lägg sedan till kod i blad1-kodfilen. Den nya koden använder objektmodellen i Excel för att lägga till en andra textrad i arbetsboken. Som standard innehåller sheet1-kodfilen följande genererade kod:

  • En partiell definition av Sheet1 klassen, som representerar kalkylbladets programmeringsmodell och ger åtkomst till objektmodellen i Excel. Mer information finns i Översikt över kalkylbladets värdobjekt och Word-objektmodell. Resten av Sheet1 klassen definieras i en dold kodfil som du inte bör ändra.

  • Händelsehanterarna Sheet1_Startup och Sheet1_Shutdown . Dessa händelsehanterare anropas när Excel läser in och tar bort din anpassning. Använd dessa händelsehanterare för att initiera anpassningen när den läses in och för att rensa resurser som används av din anpassning när den tas bort. Mer information finns i Händelser i Office-projekt.

Så här lägger du till en andra textrad i kalkylbladet med hjälp av kod

  1. Högerklicka på Blad1 i Solution Explorer och klicka sedan på Visa kod.

    Kodfilen öppnas i Visual Studio.

  2. Sheet1_Startup Ersätt händelsehanteraren med följande kod. När Blad1 öppnas lägger den här koden till en andra textrad i kalkylbladet.

    private void Sheet1_Startup(object sender, System.EventArgs e)
{
    Microsoft.Office.Tools.Excel.NamedRange nr =
        this.Controls.AddNamedRange(this.Range["A2"], "NamedRange1");
    nr.Value2 = "This text was added by using code";
}

Testa projektet

Utför ett test på din arbetsbok

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

    När du skapar projektet kompileras koden till en sammansättning som är associerad med arbetsboken. Visual Studio placerar en kopia av arbetsboken och sammansättningen i utdatamappen för projektet och konfigurerar säkerhetsinställningarna på utvecklingsdatorn så att anpassningen kan köras. Mer information finns i Skapa Office-lösningar.

  2. Kontrollera att följande text visas i arbetsboken.

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

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

  3. Stäng arbetsboken.

Rensa projektet

När du är klar med att utveckla ett projekt bör du ta bort filerna i utdatamappen för bygget och säkerhetsinställningarna som skapas av byggprocessen.

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 en grundläggande anpassning på dokumentnivå för Excel kan du lära dig mer om hur du utvecklar anpassningar från dessa ämnen:

Relaterat innehåll