Document 主項目

更新： 2008 年 7 月

適用於
本主題中的資訊僅適用於指定的 Visual Studio Tools for Office 專案和 Microsoft Office 版本。 文件層級專案 Word 2003 Word 2007 應用程式層級專案 Word 2007 如需詳細資訊，請參閱依應用程式和專案類型提供的功能。

Document 主項目表示 Word 文件 (會公開事件以及做為主控制項和 Windows Form 控制項的容器)。Document 主項目也會提供與 Word 主要 Interop 組件中 Microsoft.Office.Interop.Word.Document 類別相同的所有屬性、方法和事件。

在文件層級專案內，Document 主項目表示專案中的文件。從 Visual Studio 2008 Service Pack 1 (SP1) 開始，您也可以使用 Word 2007 應用程式層級的增益集，在執行階段產生 Document 主項目。

了解文件層級專案中的 Document 主項目

若要以程式設計方式存取專案中的文件，請使用 ThisDocument 類別。當您建立文件層級專案時，Visual Studio Tools for Office 會產生 ThisDocument 類別，做為 Word 和自訂程式碼之間的通訊連結。ThisDocument 類別衍生自 Document 主項目類別。在執行階段開啟文件時，Visual Studio Tools for Office 會自動為您具現化 ThisDocument 類別。您不應該嘗試在程式碼中直接具現化 Document 類別。

ThisDocument 類別可讓您存取 Document 主項目的成員以在自訂中執行基本工作，例如在開啟或關閉文件時執行程式碼。您也可以使用這個類別將控制項和智慧標籤加入至文件。藉由合併不同組的控制項並撰寫程式碼，您可以將控制項繫結至資料、從使用者收集資訊，以及回應使用者動作。如需詳細資訊，請參閱文件層級自訂程式設計。

ThisDocument 提供一個位置，供您開始在專案中撰寫程式碼。由於這個類別與 Word 主要 Interop 組件中的 Microsoft.Office.Interop.Word.Document 類別提供相同的屬性、方法和事件，您也可以使用 ThisDocument 存取 Word 的物件模型。如需詳細資訊，請參閱 Word 物件模型概觀。

文件主項目的限制

文件層級專案只能包含一個 Document 主項目。您無法在設計階段將新的 Document 主項目加入至專案，也無法透過程式設計方式在執行階段從文件層級自訂中建立新的 Document 主項目。

如果您在執行階段建立新的 Word 文件，這個文件的型別將為 Microsoft.Office.Interop.Word.Document。因為這不是主項目，所以無法包含任何主控制項或是 Windows Form 控制項。如需在執行階段建立文件的詳細資訊，請參閱 HOW TO：建立新文件。

了解應用程式層級專案中的 Document 主項目

從 SP1 開始，您可以在執行階段為 Word 中任何開啟的文件產生 Document 主項目。您可以使用 Document 主項目，將控制項和智慧標籤加入至關聯的文件。

若要產生 Document 主項目，請使用任何 Microsoft.Office.Interop.Word.Document 物件的 GetVstoObject 方法。如需詳細資訊，請參閱在應用程式層級增益集的執行階段中擴充 Word 文件和 Excel 活頁簿。

請參閱

概念

主項目和主控制項概觀

Word 物件模型概觀

主項目和主控制項的程式設計限制

在應用程式層級增益集的執行階段中擴充 Word 文件和 Excel 活頁簿

其他資源

Word 主控制項

Excel 主控制項

變更記錄

日期	記錄	原因
2008 年 7 月	加入有關在應用程式層級專案中使用 Document 主項目的資訊。	SP1 功能變更。