<appAddin> 元素（Visual Studio 中的 Office 开发）

项目
08/12/2011

vstov4 命名空间的 appAddin 元素存储应用程序级外接程序的特定于自定义项的信息。

<appAddin
  application
  loadBehavior
  keyName>
  <friendlyName>
  <description>
  <formRegions></formRegions>
</appAddin>

元素和特性

appAddin 元素是必需的，它在 vstov4 命名空间中。一个应用程序清单中只能定义一个 appAddin 元素。

appAddin 元素具有以下特性。

特性	说明
application	必选。标识 Microsoft Office 应用程序。其值可以为以下值之一：Excel、InfoPath、Outlook、PowerPoint、Project、Visio 或 Word。
loadBehavior	可选。默认情况下，通过将此值设置为可以启用 loadBehavior。为了进行调试，通过将此值设置为 2 可以禁用外接程序。有关更多信息，请参见应用程序级外接程序的注册表项中标题为“LoadBehavior 值”的表。
keyName	必选。此值是由应用程序用于加载外接程序的注册表项名称。有关更多信息，请参见应用程序级外接程序的注册表项。

appAddin 元素具有以下子元素。

friendlyName

可选。 friendlyName 元素在 <friendlyName> 元素（Visual Studio 中的 Office 开发）中介绍。

description

可选。 description 元素在 <description> 元素（Visual Studio 中的 Office 开发）中介绍。

formRegions

仅对包括窗体区域的 Outlook 应用程序级外接程序是必需的。 formRegions 元素在 <formRegions> 元素（Visual Studio 中的 Office 开发）中介绍。

应用程序级外接程序示例

说明

下面的代码示例演示使用 ClickOnce 部署的 Outlook 解决方案中的 appAddin。此代码示例摘自 Office 解决方案的应用程序清单中提供的一个更大的示例。

代码

        <vstov4:appAddIn 
          application="Outlook" 
          loadBehavior="3" 
          keyName="ContosoOutlookAddIn">
          <vstov4:friendlyName>
            ContosoOutlookAddIn
          </vstov4:friendlyName>
          <vstov4:description>
            ContosoOutlookAddIn - Outlook add-in 
            created with Visual Studio Tools for Office
          </vstov4:description>
          <vstov4:formRegions>
            <vstov4:formRegion
                name="OutlookAddIn1.FormRegion1">
              <vstov4:messageClass name="IPM.Note" />
              <vstov4:messageClass name="IPM.Contact" />
              <vstov4:messageClass name="IPM.Appointment" />
            </vstov4:formRegion>
          </vstov4:formRegions>
        </vstov4:appAddIn>