Excel JavaScript object model i Office-tillägg-Office-tillägg / Microsoft Docs

09/03/2020
4 minuter att läsa
- o
- R
- a
- l
- m
- +4

i den här artikeln beskrivs hur du använder Excel JavaScript API för att bygga tillägg för Excel 2016 eller senare. Det introducerar kärnkoncept som är grundläggande för att använda API och ger vägledning för att utföra specifika uppgifter som att läsa eller skriva till ett stort område, uppdatera alla celler inom intervallet och mer.

viktigt

Se använda den applikationsspecifika API-modellen för att lära dig om asynkron karaktär av Excel API: er och hur de fungerar med arbetsboken.

Kontor.JS API för Excel
Excel-specifik objektmodell
intervall
Range sample
diagram, tabeller och andra dataobjekt
skapa en tabell
skapa ett diagram
Se även

Kontor.JS API för Excel

ett Excel-tillägg interagerar med objekt i Excel med hjälp av Office JavaScript API, som innehåller två JavaScript-objektmodeller:

Excel JavaScript API: infördes med Office 2016, Excel JavaScript API ger starkt maskinskrivna objekt som du kan använda för att komma åt kalkylblad, intervall, tabeller, diagram och mer.
vanliga API: er: med Office 2013 kan det gemensamma API: et användas för att komma åt funktioner som användargränssnitt, dialogrutor och klientinställningar som är vanliga för flera typer av Office-program.

medan du sannolikt kommer att använda Excel JavaScript API för att utveckla majoriteten av funktionerna i tillägg som riktar sig till Excel 2016 eller senare, använder du också objekt i det gemensamma API. Till exempel:

kontext: objektet Context representerar runtime-miljön för tillägget och ger åtkomst till viktiga objekt i API: et. Den består av arbetsbokskonfigurationsdetaljer som contentLanguage och officeTheme och ger också information om tilläggets runtime-miljö som host och platform. Dessutom tillhandahåller den requirements.isSetSupported() – metoden, som du kan använda för att kontrollera om den angivna kravuppsättningen stöds av Excel-programmet där tillägget körs.
dokument: objektet Document tillhandahåller metoden getFileAsync(), som du kan använda för att ladda ner Excel-filen där tillägget körs.

följande bild illustrerar när du kan använda Excel JavaScript API eller vanliga API: er.

Excel-specifik objektmodell

för att förstå Excel-API: erna måste du förstå hur komponenterna i en arbetsbok är relaterade till varandra.

en arbetsbok innehåller ett eller flera kalkylblad.
ett kalkylblad innehåller samlingar av de dataobjekt som finns i det enskilda arket och ger åtkomst till celler genom Områdesobjekt.
ett intervall representerar en grupp angränsande celler.
intervall används för att skapa och placera tabeller, diagram, former och andra datavisualiserings-eller organisationsobjekt.
arbetsböcker innehåller samlingar av några av dessa dataobjekt (t.ex. tabeller) för hela arbetsboken.

intervall

ett intervall är en grupp sammanhängande celler i arbetsboken. Tillägg använder vanligtvis A1-stil notation (t.ex. B3 för den enskilda cellen i kolumn B och rad 3 eller C2:F4 för cellerna från kolumnerna C till F och raderna 2 till 4) för att definiera intervall.

intervall har tre kärnegenskaper: values, formulas och format. Dessa egenskaper får eller ställer in cellvärden, formler som ska utvärderas och den visuella formateringen av cellerna.

Range sample

följande exempel visar hur du skapar försäljningsrekord. Den här funktionen använder Range objekt för att ställa in värden, formler och format.

det här exemplet skapar följande data i det aktuella kalkylbladet:

mer information finns i Arbeta med intervall med hjälp av Excel JavaScript API.

diagram, tabeller och andra dataobjekt

Excel JavaScript API: er kan skapa och manipulera datastrukturer och visualiseringar i Excel. Tabeller och diagram är två av de vanligaste objekten, men API: erna stöder pivottabeller, former, bilder och mer.