Dela via

Arbetsboksvärdobjekt

Värdobjektet Workbook är en typ som utökar Workbook typen från den primära interop-sammansättningen för Excel. Värdobjektet Workbook innehåller alla samma egenskaper, metoder och händelser som ett Workbook objekt, men det innehåller även ytterligare funktioner.

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

I projekt på dokumentnivå finns det ett standardvärdobjekt Workbook som representerar arbetsboken i projektet. I VSTO-tilläggsprojekt kan du generera Workbook värdobjekt vid körning.

Förstå arbetsbokens värdobjekt i projekt på dokumentnivå

För att komma åt arbetsboken i ditt projekt, använd ThisWorkbook-klassen. Klassen ThisWorkbook ger dig åtkomst till medlemmar i Workbook värdobjektet för att utföra grundläggande uppgifter i anpassningen, till exempel att köra kod när arbetsboken öppnas eller stängs. Mer information finns i Programanpassningar på dokumentnivå.

Klassen ThisWorkbook tillhandahåller en plats där du kan börja skriva kod i projektet. Eftersom klassen innehåller samma egenskaper, metoder och händelser som Workbook objektet i den primära interop-sammansättningen för Excel, kan du också använda ThisWorkbook för att komma åt objektmodellen i Excel. Mer information finns i Översikt över Excel-objektmodell.

Dubbelklicka på projektobjektet ThisWorkbook i Solution Explorer för att visa arbetsboksdesignern och visa egenskaperna och händelserna för arbetsboken i fönstret Egenskaper .

Begränsningar för arbetsbokens värdobjekt i projekt på dokumentnivå

Ett projekt på dokumentnivå kan bara innehålla ett Workbook värdobjekt (det vill: ThisWorkbook klassen). Du kan inte lägga till nya Workbook värdobjekt i projektet under designtid, och du kan inte skapa nya Workbook värdobjekt under körning från en dokumentnivåanpassning.

Om du skapar en ny Excel-arbetsbok vid körning är den av typen Workbook. Eftersom det inte är ett värdobjekt kan det inte innehålla några värdkontroller eller Windows Forms-kontroller. Mer information om hur du skapar arbetsböcker under körningstid finns i Så här skapar du nya arbetsböcker programmatiskt.

Värdobjektet Workbook fungerar inte som en container för värdkontroller. Därför kan du inte lägga till några synliga kontroller i arbetsboken, men du kan lägga till komponenter, till exempel en DataSet, så att komponenterna kan delas av alla kalkylblad. I ett projekt på dokumentnivå finns komponenter som är tillgängliga för arbetsboken på fliken Komponent , fliken Data och fliken Alla Windows-formulär i verktygslådan.

Anmärkning

Office-utvecklingsverktygen i Visual Studio stöder inte delade arbetsböcker.

Förstå värdobjekt för arbetsböcker i projekt för VSTO-tillägg

I VSTO-tilläggsprojekt kan du generera ett Workbook värdobjekt under körningstid för alla arbetsböcker som är öppna i Excel. För att generera ett Workbook värdobjekt, använd metoden GetVstoObject. För mer information, se Utöka Word-dokument och Excel-arbetsböcker i VSTO-tillägg vid körtid.

Relaterat innehåll