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

發行項
08/12/2011

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

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

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

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

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

必要條件

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

包含 Microsoft Office 開發者工具的 Visual Studio 2010 版本。 如需詳細資訊，請參閱[設定電腦以開發 Office 方案](bb398242\(v=vs.100\).md)。

Word 2007 或 Word 2010。

建立專案

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

啟動 Visual Studio。
在 [檔案] 功能表上，指向 [新增]，然後按一下 [專案]。
在範本窗格中，展開 [Visual C#] 或 [Visual Basic]，接著展開 [Office]。
在展開的 [Office] 節點底下，選取 [2007] (如果您已安裝 Word 2007) 或選取 [2010] 節點 (如果您已安裝 Word 2010)。
在專案範本清單中，選取 [Word 2007 增益集] 或 [Word 2010 增益集]。
在 [名稱] 方塊中，輸入 FirstWordAddIn。
按一下 [確定]。

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

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

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

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