可以使用 ServerDocument Visual Studio Tools for Office 运行时中的类来管理文档级自定义的多个方面,即使未安装 Microsoft Office Word 和 Microsoft Office Excel 也是如此。 可以执行以下任务:
访问和修改文档或工作簿的数据缓存中的数据。 有关详细信息,请参阅文档中的缓存数据的使用。
管理与文档关联的自定义程序集。 有关详细信息,请参阅 “管理文档自定义”。
适用于: 本主题中的信息适用于 Excel 和 Word 的文档级项目。 有关详细信息,请参阅 Office 应用程序和项目类型提供的功能。
了解 ServerDocument 类
该 ServerDocument 类旨在用于未安装 Office 的计算机上。 因此,通常在不与 Office 集成的应用程序(如控制台项目或 Windows 窗体项目)而不是 Office 项目中使用此类。 使用 ServerDocument 类在 Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll 程序集中的使用。
该ServerDocument类可用于操作使用 Visual Studio 2013 创建的文档级自定义项。
有关 Visual Studio 2010 Tools for Office Runtime 和 .NET Framework 的 Office 扩展的详细信息,请参阅 Visual Studio Tools for Office 运行时概述。
注释
如果你有一个使用ServerDocument类的遗留应用程序在Visual Studio Tools for Office系统(版本 3.0 运行时)中运行,那么必须在运行该应用程序的计算机上安装Visual Studio Tools for Office系统(版本 3.0 运行时)。
Visual Studio 2010 Tools for Office runtime 无法运行这些应用程序。
处理文档中的缓存数据
该 ServerDocument 类提供可用于处理自定义文档中的数据缓存的成员。 有关缓存数据的详细信息,请参阅服务器上的文档中的缓存数据和访问数据。
下表列出了可用于处理缓存数据的成员。
| 任务 | 要使用的成员 |
|---|---|
| 确定文档是否具有数据缓存。 | 方法 IsCacheEnabled 。 |
| 访问文档中的缓存数据。 有关详细信息,请参阅 服务器上的文档中的访问数据。 |
CachedData 属性。 |
管理文档自定义
可以使用类的成员 ServerDocument 来管理与文档关联的自定义程序集。 例如,你可以以编程方式从文档中删除自定义项,以便文档不再是自定义项的一部分。
下表列出了可用于管理自定义程序集的成员。
| 任务 | 要使用的成员 |
|---|---|
| 确定文档是否是文档级自定义的一部分。 | 方法 GetCustomizationVersion 。 |
| 在运行时以编程方式将自定义项附加到文档。 有关详细信息,请参阅 如何:将托管代码扩展附加到文档 |
AddCustomization 方法之一。 |
| 以编程方式在运行时从文档中删除自定义项。 有关详细信息,请参阅 如何:从文档中删除托管代码扩展。 |
方法 RemoveCustomization 。 |
| 获取与文档关联的部署清单的 URL。 | DeploymentManifestUrl 属性。 |