<appAddin> 元素 (2007 System)

更新:2007 年 11 月

注意

适用于

本主题中的信息仅适用于指定的 Visual Studio Tools for Office 项目和 Microsoft Office 版本。

有关更多信息,请参见按应用程序和项目类型提供的功能

项目类型

  • 应用程序级项目

Microsoft Office 版本

  • 2007 Microsoft Office system

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

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

元素和属性

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

appAddin 元素具有以下属性。

属性

说明

application

必需。标识 Microsoft Office 应用程序。其值可以为以下值之一:Excel、InfoPath、Outlook、PowerPoint、Project、Visio 或 Word。

loadBehavior

可选。默认情况下,通过将此值设置为 3 可以启用 loadBehavior。为了进行调试,通过将此值设置为 2 可以禁用外接程序。有关更多信息,请参见应用程序级外接程序的注册表项中标题为“LoadBehavior 值”的表。

keyName

必需。此值是由应用程序用于加载外接程序的注册表项名称。有关更多信息,请参见应用程序级外接程序的注册表项

appAddin 元素具有以下子元素。

friendlyName

friendlyName 元素在 <friendlyName> 元素 (2007 System) 中介绍。

description

可选。description 元素在 <description> 元素 (2007 System) 中介绍。

formRegions

仅对包括窗体区域的 Outlook 应用程序级外接程序是必需的。formRegions 元素在 <formRegions> 元素 (2007 System) 中介绍。

备注

您可以手动编辑 Visual Studio Tools for Office 解决方案的应用程序清单和部署清单。应用程序清单和部署清单在经过编辑后,必须由清单生成和编辑工具(mage.exe 和 mageui.exe)重新签名。先对应用程序清单进行签名,再对部署清单进行签名。有关更多信息,请参见清单生成和编辑工具 (Mage.exe)图形化客户端中的清单生成和编辑工具 (MageUI.exe)

应用程序级外接程序示例

说明

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

代码

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

请参见

参考

Office 解决方案的应用程序清单 (2007 System)

Office 解决方案的部署清单 (2007 System)

ClickOnce 应用程序清单