AddIn 主項目

更新： 2008 年 7 月

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

Microsoft.Office.Tools.AddIn 類別 (Class) 是使用 Visual Studio Tools for Office 建立之應用程式層級增益集的「主項目」(Host Item)。主項目是 Visual Studio Tools for Office 方案中的一個類別，可提供程式碼的進入點。 

了解 AddIn 與 ThisAddIn 類別

AddIn 類別可提供全部 Visual Studio Tools for Office 增益集都有的核心功能。但是，您不應該明確地具現化這個類別或直接在程式碼中使用它，

而是應該使用 ThisAddIn 類別。Visual Studio Tools for Office 會在您的增益集專案中產生這個類別，做為 Microsoft Office 應用程式與您的增益集程式碼之間的通訊連結。ThisAddIn 類別衍生自 AddIn。當 Microsoft Office 應用程式載入您的增益集時，Visual Studio Tools for Office 會自動為您具現化這個類別。

ThisAddIn 提供一個位置，供您開始在專案中撰寫程式碼。您也可以使用 ThisAddIn 來執行類似存取主應用程式之物件模型之類的工作。如需詳細資訊，請參閱應用程式層級增益集程式設計。

在 Outlook 2007 增益集專案中使用 AddIn 和 ThisAddIn

Microsoft Office Outlook 2007 的增益集專案使用不同的主項目 (Microsoft.Office.Tools.Outlook.OutlookAddIn)。這個類別衍生自 AddIn，而且加入了一些額外的功能來支援表單區域。如需表單區域的詳細資訊，請參閱建立 Outlook 表單區域。

在 Outlook 2007 的增益集專案中，ThisAddIn 類別衍生自 OutlookAddIn。在 Outlook 2007 增益集中使用 ThisAddIn 類別的方式，就和在其他 Microsoft Office 應用程式增益集中使用這個類別一樣。

用於各種工作的成員

下表說明常見工作並顯示您可以用來執行這些工作的 ThisAddIn 類別成員。

工作	使用的成員
載入增益集時，執行程式碼來初始化增益集。	將程式碼加入至 ThisAddIn_Startup 方法。這是 Startup 事件的預設事件處理常式。如需詳細資訊，請參閱 Visual Studio Tools for Office 專案事件。
在即將卸載增益集之前，清除增益集使用的資源。	將程式碼加入至 ThisAddIn_Shutdown 方法。這是 Shutdown 事件的預設事件處理常式。如需詳細資訊，請參閱 Visual Studio Tools for Office 專案事件。
透過存取物件模型自動化主應用程式	使用 ThisAddIn 類別的 Application 欄位。這樣會傳回您的增益集所處理之應用程式的 Application 類別執行個體 (Instance)。如需詳細資訊，請參閱應用程式層級增益集程式設計。
建立在任何開啟的 Word 文件或 Excel 活頁簿中都能辨識的智慧標籤。這是 Visual Studio 2008 Service Pack 1 (SP1) 的新功能。	使用 ThisAddIn 類別的 VstoSmartTags 欄位。只有在安裝 SP1 之後建立的 Excel 2007 和 Word 2007 增益集專案中，才能使用這個欄位。如需詳細資訊，請參閱智慧標籤概觀。
將增益集中的物件公開給其他 Microsoft Office 方案。	覆寫 RequestComAddInAutomationService 方法。如需詳細資訊，請參閱在應用程式層級增益集中呼叫其他 Office 方案的程式碼。
實作擴充性介面來自訂 2007 Microsoft Office system 中的功能。	覆寫 RequestService 方法以傳回可實作介面之類別的執行個體。如需詳細資訊，請參閱使用擴充性介面自訂 UI 功能。 注意事項： 若要自訂功能區 UI，您也可以覆寫 CreateRibbonExtensibilityObject 方法。

請參閱

工作

逐步解說：在應用程式層級增益集中呼叫 VBA 的程式碼

概念

應用程式層級增益集程式設計

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

使用擴充性介面自訂 UI 功能

在應用程式層級增益集中呼叫其他 Office 方案的程式碼

應用程式層級增益集程式設計入門

Visual Studio Tools for Office 專案事件

變更記錄

日期	記錄	原因
2008 年 7 月	加入有關使用應用程式層級增益集，將智慧標籤加入至文件的資訊。	SP1 功能變更。