自定义文档属性概述

更新:2007 年 11 月

适用对象

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

项目类型

  • 文档级项目

Microsoft Office 版本

  • 2007 Microsoft Office system

  • Microsoft Office 2003

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

如果文档是文档级自定义项的一部分,Visual Studio Tools for Office 将赋予文档两个自定义属性:_AssemblyLocation_AssemblyName。当用户打开文档时,Microsoft Office 将检查这些自定义文档属性。如果这些属性存在于文档中,应用程序将加载 Visual Studio Tools for Office 运行时,后者将启动自定义项。有关更多信息,请参见Visual Studio Tools for Office 解决方案的结构

这些属性的值取决于设计解决方案时所针对的 Microsoft Office 的版本:

  • Microsoft Office 的 2007 版。

  • Microsoft Office 的 2003 版。

2007 Microsoft Office 解决方案的自定义属性

  • _AssemblyName

    此属性包含 Visual Studio Tools for Office 加载程序中某个接口的 CLSID。此 CLSID 值为 4E3C66D5-58D4-491E-A7D4-64AF99AF6E8B。绝对不要更改此值。

  • _AssemblyLocation

    此属性包含一个字符串,该字符串提供有关自定义项部署清单的详细信息。有关清单的更多信息,请参见 Office 解决方案中的应用程序和部署清单

_AssemblyLocation 属性的格式

_AssemblyLocation 属性值可以有不同的格式,具体取决于解决方案的部署方式:

  • 如果发布解决方案的目的是为了从网站、UNC 路径或者 CD 或 USB 驱动器中进行安装,_AssemblyLocation 属性的格式为 DeploymentManifestPath|SolutionID。下面的字符串是一个示例:

    file://deployserver/MyShare/ExcelWorkbook1.vsto|74744e4b-e4d6-41eb-84f7-ad20346fe2d9

  • 如果从 Visual Studio 中运行或调试解决方案,_AssemblyLocation 属性的格式为 DeploymentManifestName|SolutionID|vstolocal。下面的字符串是一个示例:

    ExcelWorkbook1.vsto|74744e4b-e4d6-41eb-84f7-ad20346fe2d9|vstolocal

SolutionID 是 Visual Studio Tools for Office 运行时用于标识解决方案的 GUID。SolutionID 是在您生成项目时自动生成的。vstolocal 一词指示 Visual Studio Tools for Office 运行时应从文档所在的文件夹中加载程序集。

Microsoft Office 2003 解决方案的自定义属性

  • _AssemblyName

    此属性包含一星号 (*)。它向 Microsoft Office 应用程序指示:文档具有 Visual Studio Tools for Office 自定义项。

  • _AssemblyLocation

    此属性包含运行时存储控件的 GUID。有关更多信息,请参见 运行时存储控件概述

请参见

任务

如何:使用 ClickOnce 部署 Office 解决方案 (2007 System)

如何:创建和修改自定义文档属性

概念

文档级自定义项的体系结构

运行时存储控件概述

Office 解决方案中的应用程序和部署清单

其他资源

Visual Studio Tools for Office 解决方案的结构