Share via


使用 ServerDocument 类管理服务器上的文档

可以使用 ServerDocument Visual Studio Tools for 办公室 运行时中的类来管理文档级自定义的多个方面,即使未安装 Microsoft 办公室 Word 和 Microsoft 办公室 Excel。 可以执行以下任务:

  • 访问和修改文档或工作簿的数据缓存中的数据。 有关详细信息,请参阅 处理文档中的缓存数据。

  • 管理与文档关联的自定义程序集。 有关详细信息,请参阅 “管理文档自定义”。

    适用于: 本主题中的信息适用于 Excel 和 Word 的文档级项目。 有关详细信息,请参阅办公室应用程序和项目类型提供的功能。

了解 ServerDocument 类

ServerDocument类旨在用于未安装办公室的计算机上。 因此,通常在未与办公室集成(例如控制台项目或Windows 窗体项目)而不是办公室项目的应用程序中使用此类。 ServerDocument使用 Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll 程序集中的类。

ServerDocument 类可用于对使用 Visual Studio 2013 创建的文档级自定义项进行操作。

有关 Visual Studio 2010 Tools for 办公室 Runtime 和 .NET Framework 的办公室扩展的详细信息,请参阅 Visual Studio Tools for 办公室 运行时概述

注意

如果你有使用系统(版本 3.0 运行时)中的类的Visual Studio Tools for Office旧应用程序ServerDocument,则必须Visual Studio Tools for Office在运行应用程序的计算机上安装系统(版本 3.0 运行时)。 无法 Visual Studio 2010 Tools for Office runtime 运行这些应用程序。

处理文档中的缓存数据

ServerDocument 类提供可用于处理自定义文档中的数据缓存的成员。 有关缓存数据的详细信息,请参阅服务器上的文档中的缓存数据和访问数据。

下表列出了可用于处理缓存数据的成员。

任务 供使用的成员
确定文档是否具有数据缓存。 IsCacheEnabled 方法。
访问文档中的缓存数据。

有关详细信息,请参阅 服务器上的文档中的访问数据。
CachedData 属性。

管理文档自定义

可以使用类的成员 ServerDocument 来管理与文档关联的自定义程序集。 例如,你可以以编程方式从文档中删除自定义项,以便文档不再是自定义项的一部分。

下表列出了可用于管理自定义程序集的成员。

任务 供使用的成员
确定文档是否是文档级自定义的一部分。 GetCustomizationVersion 方法。
在运行时以编程方式将自定义项附加到文档。

有关详细信息,请参阅 如何:将托管代码扩展附加到文档
其中 AddCustomization 一种方法。
以编程方式在运行时从文档中删除自定义项。

有关详细信息,请参阅 如何:从文档中删除托管代码扩展。
RemoveCustomization 方法。
获取与文档关联的部署清单的 URL。 DeploymentManifestUrl 属性。