逐步解說：建立 Word 的第一個應用程式層級增益集

發行項
08/21/2008

更新： 2008 年 7 月

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

本主題中的資訊僅適用於指定的 Visual Studio Tools for Office 專案和 Microsoft Office 版本。

專案類型

應用程式層級專案

Microsoft Office 版本

Word 2007
Word 2003

如需詳細資訊，請參閱依應用程式和專案類型提供的功能。

本入門逐步解說將示範如何建立 Microsoft Office Word 的應用程式層級增益集。不論開啟哪一份文件，您在這類方案中建立的功能都可供應用程式本身使用。

這個逐步解說將說明下列工作：

建立適用於 Word 2003 或 Word 2007 的 Word 增益集專案。
撰寫可使用 Word 物件模型的程式碼，儲存文件時便可加入文字。
建置和執行專案來進行測試。
清除已完成的專案，好讓增益集不要在開發電腦上自動執行。

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

必要條件

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

Visual Studio Tools for Office (Visual Studio 2008 Professional 和 Visual Studio Team System 的選擇性元件)。
Word 2003 或 Word 2007。

根據預設，Visual Studio Tools for Office 會與列出的 Visual Studio 版本一起安裝。若要檢查電腦上是否已安裝此元件，請參閱安裝 Visual Studio Tools for Office。

建立專案

若要在 Visual Studio 中建立新的 Word 增益集專案

啟動 Visual Studio。
在 [檔案] 功能表上，指向 [新增]，然後按一下 [專案]。
在 [專案類型] 窗格中，展開 [Visual C#] 或 [Visual Basic]，然後再展開 [Office]。
如果您要開發 Word 2007 增益集，請選取 [2007] 資料夾，如果要開發 Word 2003 增益集，則請選取 [2003] 資料夾。
在 [範本] 窗格中，選取 [Word 2003 增益集] 或 [Word 2007 增益集]。
在 [名稱] 方塊中，輸入 FirstWordAddIn。
按一下 [確定]。

Visual Studio 會建立 FirstWordAddIn 專案，並在編輯器中開啟 ThisAddIn 程式碼檔。

撰寫程式碼以將文字加入儲存的文件

接著，將程式碼加入至 ThisAddIn 程式碼檔。新程式碼會使用 Word 物件模型，將未定案文字加入至每個儲存的文件中。根據預設，ThisAddIn 程式碼檔包含下列產生的程式碼：

ThisAddIn 類別的部分定義。這個類別提供您撰寫程式碼的進入點 (Entry Point)，並提供對 Word 物件模型的存取。如需詳細資訊，請參閱 AddIn 主項目。ThisAddIn 類別的其餘部分則定義於您不應修改的隱藏程式碼檔中。
ThisAddIn_Startup 和 ThisAddIn_Shutdown 事件處理常式。當 Word 載入和卸載增益集時，會呼叫這些事件處理常式。請使用這些事件處理常式，在增益集載入時將它初始化，以及在增益集卸載時清除它所用的資源。如需詳細資訊，請參閱 Visual Studio Tools for Office 專案事件。

若要將文字段落加入儲存的文件

在 ThisAddIn 程式碼檔中，加入下列程式碼至 ThisAddIn 類別。新的程式碼會定義 DocumentBeforeSave 事件的事件處理常式，該事件是在儲存文件時所引發的。

當使用者儲存文件時，事件處理常式會將新文字加入至文件開頭。

Private Sub Application_DocumentBeforeSave(ByVal Doc As Word.Document, ByRef SaveAsUI As Boolean, _
    ByRef Cancel As Boolean) Handles Application.DocumentBeforeSave
    Doc.Paragraphs(1).Range.InsertParagraphBefore()
    Doc.Paragraphs(1).Range.Text = "This text was added by using code."
End Sub

void Application_DocumentBeforeSave(Word.Document Doc, ref bool SaveAsUI, ref bool Cancel)
{
    Doc.Paragraphs[1].Range.InsertParagraphBefore();
    Doc.Paragraphs[1].Range.Text = "This text was added by using code.";
}

注意事項：
此程式碼會使用索引值 1 來存取 Paragraphs 集合中的第一個段落。雖然 Visual Basic 和 Visual C# 都使用以 0 起始的陣列，但在 Word 物件模型中，大多數集合的陣列下限都是 1。如需詳細資訊，請參閱使用 Visual Basic 和 C# 進行程式設計的比較。

如果使用的是 C#，請將下列必要的程式碼加入 ThisAddIn_Startup 事件處理常式中。這段程式碼是用來連接 Application_DocumentBeforeSave 事件處理常式和 DocumentBeforeSave 事件。
```
this.Application.DocumentBeforeSave += 
    new Word.ApplicationEvents4_DocumentBeforeSaveEventHandler(Application_DocumentBeforeSave);
```

若要在儲存文件時修改文件，前面的程式碼範例可以使用下列物件：

ThisAddIn 類別的 Application 欄位。Application 欄位會傳回 Microsoft.Office.Interop.Word.Application 物件，代表 Word 目前的執行個體。
DocumentBeforeSave 事件的事件處理常式的 Doc 參數。Doc 參數是 Microsoft.Office.Interop.Word.Document 物件，代表儲存的文件。如需詳細資訊，請參閱 Word 物件模型概觀。

測試專案

若要測試專案

按 F5 建置及執行專案。

當您建置專案時，程式碼會編譯到包含在專案建置輸出資料夾中的組件。Visual Studio 也會建立一組登錄項目，好讓 Word 探索和載入增益集，而且會設定開發電腦中的安全性設定以執行增益集。如需詳細資訊，請參閱 Office 方案建置程序概觀。
在 Word 中，儲存使用中的文件。
確認下列文字已加入文件中。

This text was added by using code.
關閉 Word。

清除專案

當您完成專案開發時，請從開發電腦移除增益集組件、登錄項目和安全性設定。否則，每次在開發電腦上開啟 Word 時，增益集將會繼續執行。

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

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

後續步驟

現在您已經建立 Word 的基本應用程式層級增益集，可以從下列主題進一步了解如何開發增益集：

您可以在增益集中執行的一般程式設計工作：應用程式層級增益集程式設計。
Word 增益集專有的程式設計工作：Word 應用程式層級增益集開發。
使用 Word 物件模型：Word 物件模型概觀。
自訂 Word 的 UI，例如，透過將自訂索引標籤加入至功能區，或建立您專屬自訂工作窗格的方式：Office UI 自訂。
建置及偵錯 Word 應用程式層級增益集：建置和偵錯 Office 方案。
部署 Word 應用程式層級增益集：部署 Office 方案。

請參閱

變更記錄

日期	記錄	原因
2008 年 7 月	加入主題。	資訊加強。

2008 年 7 月

加入主題。

資訊加強。

共用方式為