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

项目
08/18/2008

更新：2007 年 11 月

注意	适用于
本主题中的信息仅适用于指定的 Visual Studio Tools for Office 项目和 Microsoft Office 版本。有关更多信息，请参见按应用程序和项目类型提供的功能。	项目类型文档级项目应用程序级项目 Microsoft Office 版本 2007 Microsoft Office system

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

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

项目类型

文档级项目
应用程序级项目

Microsoft Office 版本

2007 Microsoft Office system

Visual Studio Tools for Office 解决方案中的应用程序清单是一个 XML 文件，该文件描述加载到 Microsoft Office 解决方案中的程序集。

Visual Studio Tools for Office 使用在 ClickOnce 应用程序清单引用中定义的 ClickOnce 应用程序清单架构。

Visual Studio Tools for Office 应用程序清单使用以下 ClickOnce 元素和属性。

元素	说明	属性
<assembly> 元素（ClickOnce 应用程序）	必需。顶级元素。	manifestVersion
<assemblyIdentity> 元素（ClickOnce 应用程序）	必需。标识 ClickOnce 应用程序的主程序集。	name version publicKeyToken processorArchitecture language
<trustInfo> 元素（ClickOnce 应用程序）	标识应用程序的安全要求。	无
<entryPoint> 元素（ClickOnce 应用程序）	必需。标识应用程序代码执行的入口点。	name dependencyName customHostSpecified
<dependency> 元素（ClickOnce 应用程序）	必需。标识运行应用程序所需的每个依赖项。O也可以有选择地标识需要预先安装的程序集。	无
<file> 元素（ClickOnce 应用程序）	必需。标识应用程序所使用的每个非程序集文件。可以包括与该文件关联的组件对象模型 (COM) 隔离数据。	name size

Visual Studio Tools for Office 应用程序清单具有 co.v1 命名空间中的以下元素。

<entryPoint>
    <co.v1:customHostSpecified />
</entryPoint>

Visual Studio Tools for Office 应用程序清单还具有 vstav2 命名空间中的以下元素和属性。

<addIn>
    <entryPoints>
        <entryPoint>
        </entryPoint>
    </entryPoints>
    <update></update>
    <application>
        <customization>
        </customization>
    </application
</addIn>

元素	说明	属性
<customHostSpecified> 元素	必需。将清单专门标识为 Office 解决方案。	无
<addin> 元素 (2007 System)	必需。将入口点存储到单个命名空间中。	无
<entryPoints> 元素 (2007 System)	必需。对所有要运行的程序集进行分组。	无
<entryPoint> 元素 (2007 System)	必需。标识要运行的程序集。	class contract
<update> 元素 (2007 System)	必需。配置解决方案的更新。	enabled expiration
<application> 元素 (2007 System)	必需。将特定于应用程序的信息封装为单个节点。	无
<customization> 元素 (2007 System)	必需。在单独的命名空间中存储特定于应用程序宿主的信息。	xmlns
<document> 元素 (2007 System)	仅对文档级解决方案是必需的。存储特定于自定义项的信息。	solutionId
<appAddin> 元素 (2007 System)	仅对应用程序级解决方案是必需的。存储特定于自定义项的信息。	application loadBehavior keyName
<friendlyName> 元素 (2007 System)	可选。存储在已安装外接程序列表中显示的外接程序的名称。	无
<description> 元素 (2007 System)	仅对应用程序级外接程序是必需的。存储在已安装程序列表中显示的说明。	无
<formRegions> 元素 (2007 System)	仅对包括窗体区域的 Outlook 2007 外接程序是必需的。	无
<formRegion> 元素 (2007 System)	仅对包括窗体区域的 Outlook 2007 外接程序是必需的。	name

备注

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

文件位置

应用程序清单特定于解决方案的一个版本。因此，应用程序清单应与部署清单分开存储。Visual Studio 将特定于版本的文件放置在一个以关联版本命名的子目录中，该关联版本位于发布文件夹中的 Application Files 子目录中。

文件名语法

应用程序清单文件的名称应当是该应用程序的完整名称和扩展名（在 assemblyIdentity 元素中标识），后跟扩展名 .manifest。例如，引用 OutlookAddIn1.dll 自定义项的应用程序清单应使用下面的文件名语法。

OutlookAddIn1.dll.manifest

ExcelWorkbook1.dll.manifest

文档级自定义项示例

说明

下面的代码示例演示应用程序清单的几个部分，它们特定于某个 Visual Studio Tools for Office 解决方案。这是一个 Microsoft Office Excel 2007 文档级自定义项。

代码

<entryPoint>
    <co.v1:customHostSpecified />
</entryPoint> 
[...]
<vstav2:addIn xmlns:vstav2="urn:schemas-microsoft-com:vsta.v2">
    <vstav2:entryPoints>
        <vstav2:entryPoint class="ExcelWorkbook1.ThisWorkbook">
            <assemblyIdentity
                name="ExcelWorkbook1"
                version="1.0.0.0"
                language="neutral"
                processorArchitecture="msil" />
        </vstav2:entryPoint>
        <vstav2:entryPoint class="ExcelWorkbook1.Sheet1">
            <assemblyIdentity
                name="ExcelWorkbook1"
                version="1.0.0.0"
                language="neutral"
                processorArchitecture="msil" />
        </vstav2:entryPoint>
        <vstav2:entryPoint class="ExcelWorkbook1.Sheet2">
            <assemblyIdentity
                name="ExcelWorkbook1"
                version="1.0.0.0"
                language="neutral"
                processorArchitecture="msil" />
        </vstav2:entryPoint>
        <vstav2:entryPoint class="ExcelWorkbook1.Sheet3">
            <assemblyIdentity
                name="ExcelWorkbook1"
                version="1.0.0.0"
                language="neutral"
                processorArchitecture="msil" />
        </vstav2:entryPoint>
    </vstav2:entryPoints>
    <vstav2:update enabled="true">
        <vstav2:expiration maximumAge="7" unit="days" />
    </vstav2:update>
    <vstav2:application>
        <vstov3:customization
            xmlns:vstov3="urn:schemas-microsoft-com:vsto.v3">
        <vstov3:document
            solutionId="989..." />
        </vstov3:customization>
    </vstav2:application>
</vstav2:addIn>

应用程序级外接程序示例

说明

下面的代码示例演示应用程序清单的几个部分，它们特定于某个 Visual Studio Tools for Office 解决方案。这是一个 Microsoft Office Outlook 2007 应用程序级外接程序，该外接程序包括一个窗体区域。

代码

<entryPoint>
    <co.v1:customHostSpecified />
</entryPoint> 
[...]
<vstav2:addIn xmlns:vstav2="urn:schemas-microsoft-com:vsta.v2">
    <vstav2:entryPoints>
        <vstav2:entryPoint class="OutlookAddIn1.ThisAddIn">
            <assemblyIdentity
                name="OutlookAddIn1"
                version="1.0.0.0"
                language="neutral"
                processorArchitecture="msil" />
        </vstav2:entryPoint>
    </vstav2:entryPoints>
    <vstav2:update enabled="true">
        <vstav2:expiration maximumAge="7" unit="days" />
    </vstav2:update>
    <vstav2:application>
        <vstov3:customization
            xmlns:vstov3="urn:schemas-microsoft-com:vsto.v3">
            <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>
        </vstov3:customization>
    </vstav2:application>
</vstav2:addIn>

请参见

参考

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

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

ClickOnce 应用程序清单

通过

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

备注

文件位置

文件名语法

文档级自定义项示例

说明

代码

应用程序级外接程序示例

说明

代码

请参见

参考

其他资源