Dela via

Dokumentvärdobjekt

Värdobjektet Document är en typ som utökar Document typen från den primära interopsammansättningen för Word. Värdobjektet Document innehåller alla samma egenskaper, metoder och händelser som ett Document objekt, men det exponerar även ytterligare händelser och fungerar som en container för värdkontroller och Windows Forms-kontroller.

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

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

Förstå dokumentvärdobjektet i projekt på dokumentnivå

Använd klassen ThisDocument för att komma åt dokumentet i projektet. När du skapar ett projekt på dokumentnivå genererar ThisDocument Visual Studio klassen som fungerar som kommunikationslänk mellan Word och din anpassningskod. Klassen ThisDocument ger dig åtkomst till medlemmar i Document värdobjektet för att utföra grundläggande uppgifter i anpassningen, till exempel att köra kod när dokumentet öppnas eller stängs. Du kan också använda klassen för att lägga till kontroller i dokumentet. Genom att kombinera olika uppsättningar kontroller och skriva kod kan du binda kontrollerna till data, samla in information från användaren och svara på användaråtgärder. Mer information finns i Programanpassningar på dokumentnivå.

Klassen ThisDocument 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 Document objektet i den primära interop-sammansättningen för Word, kan du också använda ThisDocument för att komma åt objektmodellen i Word. Mer information finns i Översikt över Word-objektmodell.

Begränsningar för dokumentvärdobjektet i projekt på dokumentnivå

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

Om du skapar ett nytt Word-dokument vid körning är det av typen Document. 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 dokument under körning finns i Så här gör du för att skapa nya dokument programmatiskt.

Förstå värdobjekt för dokument i projekt på applikationsnivå

I VSTO-tilläggsprojekt kan du generera ett Document värdobjekt vid körning för alla dokument som är öppna i Word. Du kan använda värdobjektet Document för att lägga till kontroller i det associerade dokumentet eller för att hantera händelser som inte är tillgängliga för Document objekt.

För att generera ett Document 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