逐步解說：建立 Word 的第一個檔層級自定義

發行項
01/13/2024

本入門逐步解說將示範如何建立 Microsoft Office Word 的文件層級自訂。只有在特定的文件開啟時，才能使用您在這種解決方案中建立的功能。您不能使用文件層級自訂來進行應用程式層級的變更，例如在任何文件開啟時顯示新功能區索引標籤。

適用於： 本主題中的資訊適用於 Word 的檔案層級專案。如需詳細資訊，請參閱 Office 應用程式 lication 和項目類型所提供的功能。

本逐步解說將說明下列工作：

建立 Word 文件專案。
將文字加入 Visual Studio 設計工具裝載的文件。
撰寫可使用 Word 物件模型的程式碼，該程式碼會在自訂文件開啟時將文字加入此文件。
建置和執行專案來進行測試。
清除專案，將不需要的組建檔案和安全性設定從開發電腦上移除。

注意

在下列指示的某些 Visual Studio 使用者介面項目中，您的電腦可能會顯示不同的名稱或位置：您所擁有的 Visual Studio 版本以及使用的設定會決定這些項目。如需詳細資訊，請參閱將 IDE 個人化。

必要條件

您需要下列元件才能完成這個逐步解說：

此版 Visual Studio 包含 Microsoft Office Developer Tools。如需詳細資訊，請參閱設定計算機來開發 Office 解決方案。
Microsoft Word

建立專案

在 Visual Studio 中建立新的 Word 文件專案

啟動 Visual Studio。
在 [檔案] 功能表上，指向 [開新檔案] ，然後按一下 [專案] 。
在 [ 建立新專案 ] 對話框中，選取 Word VSTO 文件 專案。

注意

您也可以在 [建立新專案] 對話框頂端的 [搜尋] 文本框中輸入 Office 產品名稱來搜尋範本。例如，輸入 Excel 會顯示 Excel 的所有項目範本。您也可以選取 [項目類型] 下拉式方塊中的 [Office]，篩選範本清單，只顯示 Office 的範本。如需詳細資訊，請參閱在Visual Studio中建立新專案。
按一下 [下一步] 。
在 [設定新專案] 對話框的 [名稱] 方塊中輸入 FirstWorkbookCustomization，然後按兩下 [建立]。
從 Visual Studio Tools for Office 專案精靈中選取 [建立新檔]，然後按兩下 [確定]。
- Visual Studio 會建立 FirstDocumentCustomization 專案，並將 FirstDocumentCustomization 檔和 ThisDocument 程式代碼檔案新增至專案。 FirstDocumentCustomization 文件會自動在設計工具中開啟。

在設計工具中關閉並重新開啟檔

如果您在開發專案時故意或不小心關閉了設計工具中的文件，您都可以重新開啟它。

在設計工具中關閉並重新開啟文件

按兩下設計工具視窗的 [關閉] 按鈕（X），以關閉 檔案。
在 方案總管 中，以滑鼠右鍵按兩下 ThisDocument 程式代碼檔案，然後按兩下 [檢視設計工具]。

- 或 -

在 方案總管 中，按兩下ThisDocument程式碼檔案。

將文字新增至設計工具中的檔

您可以修改設計工具中開啟的文件，藉此設計自訂的使用者介面 (UI)。例如，您可以加入文字、表格或 Word 控制項。如需如何使用設計工具的詳細資訊，請參閱 Visual Studio環境中的 Office 專案。

使用設計工具將文字加入文件

在設計工具開啟的文件中，輸入下列文字。

此文字是使用設計工具新增的。

以程序設計方式將文字新增至檔

接著，將程式碼加入 ThisDocument 程式碼檔。新程式碼會使用 Word 物件模型，將第二段的文字加入文件。 ThisDocument 程式碼檔預設包含下列產生的程式碼：

ThisDocument 類別的部分定義，此定義代表該文件的程式設計模型，而且會提供 Word 物件模型的存取。如需詳細資訊，請參閱檔主專案和 Word 物件模型概觀。 ThisDocument 類別的其餘部分則定義於您不應修改的隱藏程式碼檔中。
ThisDocument_Startup 和 ThisDocument_Shutdown 事件處理常式。開啟和關閉文件時會呼叫這些事件處理常式。請使用這些事件處理常式，在文件開啟時初始化自訂，以及在文件關閉時清除自訂所用的資源。如需詳細資訊，請參閱 Office 專案中的事件。

使用程式碼將第二段文字加入文件

在 [方案總管] 中，以滑鼠右鍵按兩下 [ThisDocument]，然後按兩下 [檢視程序代碼]。

程式碼檔案隨即在 Visual Studio 中開啟。
以下列程式碼取代 ThisDocument_Startup 事件處理常式。開啟文件時，這段程式碼會將第二段文字加入文件。
- C#
- VB
```
private void ThisDocument_Startup(object sender, System.EventArgs e)
{
    this.Paragraphs[1].Range.InsertParagraphAfter();
    this.Paragraphs[2].Range.Text = "This text was added by using code.";
}
```
```
Private Sub ThisDocument_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup
    Me.Paragraphs(1).Range.InsertParagraphAfter()
    Me.Paragraphs(2).Range.Text = "This text was added by using code."
End Sub
```
注意

這個程式碼會使用索引值 1 存取 Paragraphs 屬性的第一個段落。雖然 Visual Basic 和 Visual C# 都是使用以 0 為起始的陣列，但是在 Word 物件模型中，大多數集合的陣列界限下限都是 1。如需詳細資訊，請參閱在 Office 方案中撰寫程式代碼。

測試專案

測試文件

按 F5 建置及執行專案。

當您建置專案時，程式碼會編譯為與文件相關聯的組件。 Visual Studio 會將文件複本和組件置於專案的建置輸出資料夾中，而且會設定開發電腦中的安全性設定以執行自訂。如需詳細資訊，請參閱建置 Office 解決方案。
確認文件中出現下列文字。

此文字是使用設計工具新增的。

This text was added by using code.
關閉文件。

清除專案

當您完成專案開發時，必須移除建置輸出資料夾中的檔案和建置程序建立的安全性設定。

清除開發電腦上已完成的專案

在 Visual Studio 中，按一下 [建置] 功能表上的 [清除方案] 。

下一步

現在您已經建立 Word 的基本文件層級自訂，可以從下列主題進一步了解如何開發自訂：

您可以在檔案層級自定義中執行的一般程式設計工作：程式檔層級自定義。
Word 檔層級自定義專屬的程序設計工作： Word 解決方案。
使用 Word 的物件模型： Word 物件模型概觀。
例如，藉由將自定義索引標籤新增至功能區或建立您自己的動作窗格，來自定義 Word 的 UI： Office UI 自定義。
使用 Visual Studio 中 Office 解決方案提供的擴充 Word 物件來執行無法使用 Word 物件模型的工作（例如，在檔和使用 Windows Forms 數據系結模型將 Word 控件系結至數據上裝載 Managed 控件）：使用擴充物件將 Word 自動化。
建置和偵錯 Word 的檔層級自定義：建置 Office 解決方案。
部署 Word 的文件層級自定義：部署 Office 解決方案。