Export (0) Print
Expand All

Managing Documents on a Server by Using the ServerDocument Class

You can use the ServerDocument class in the Visual Studio Tools for Office runtime to manage several aspects of document-level customizations, even if Microsoft Office Word and Microsoft Office Excel are not installed. You can perform the following tasks:

Applies to: The information in this topic applies to document-level projects for the following applications: Excel 2013 and Excel 2010; Word 2013 and Word 2010. For more information, see Features Available by Office Application and Project Type.

The ServerDocument class is designed to be used on computers that do not have Office installed. Therefore, you typically use this class in applications that do not integrate with Office, such as Console projects or Windows Forms projects, rather than Office projects. Use the Microsoft.VisualStudio.Tools.Applications.ServerDocument class in the Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll assembly.

The ServerDocument class can be used to operate on document-level customizations that were created by using Visual Studio 2012.

For more information about the Visual Studio 2010 Tools for Office Runtime and the Office extensions for the .NET Framework, see Visual Studio Tools for Office Runtime Overview.

Note Note

If you have a legacy application that uses the ServerDocument class in the Visual Studio Tools for Office system (version 3.0 Runtime), the Visual Studio Tools for Office system (version 3.0 Runtime) must be installed on computers that run the application. The Visual Studio 2010 Tools for Office Runtime cannot run these applications.

The ServerDocument class provides members you can use to work with the data cache in customized documents. For more information about cached data, see Caching Data and Accessing Data in Documents on the Server.

The following table lists the members you can use to work with cached data.

Task

Member to use

To determine whether a document has a data cache.

The IsCacheEnabled method.

To access the cached data in a document.

For more information, see Accessing Data in Documents on the Server.

The CachedData property.

You can use members of the ServerDocument class to manage the customization assembly that is associated with a document. For example, you can programmatically remove the customization from a document so that the document is no longer part of a customization.

The following table lists the members you can use to manage the customization assembly.

Task

Member to use

To determine whether a document is part of a document-level customization.

The GetCustomizationVersion method.

To programmatically attach a customization to a document at run time.

For more information, see How to: Attach Managed Code Extensions to Documents

One of the AddCustomization methods.

To programmatically remove a customization from a document at run time.

For more information, see How to: Remove Managed Code Extensions from Documents.

The RemoveCustomization method.

To get the URL of the deployment manifest that is associated with the document.

The DeploymentManifestUrl property.

Show:
© 2014 Microsoft