AddIn 宿主项

更新：2007 年 11 月

Microsoft.Office.Tools.AddIn 类是使用 Visual Studio Tools for Office 创建的应用程序级外接程序的宿主项。宿主项是 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 类的实例。有关更多信息，请参见应用程序级外接程序编程。
创建在任何打开的 Word 文档或 Excel 工作簿中都能识别的智能标记。此功能是 Visual Studio 2008 Service Pack 1 (SP1) 中新增的。	使用 VstoSmartTags 类的 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 项目事件

修订记录