There are two different versions of the ServerDocument class, one for each version of the Visual Studio Tools for Office runtime. Use the one that corresponds to the solution's version of Microsoft Office:

• Use the Microsoft.VisualStudio.Tools.Applications..::.ServerDocument class with customizations for Excel 2007 and Word 2007. This class is provided by the Microsoft Visual Studio Tools for the Microsoft Office system (version 3.0 Runtime).

• Use the ServerDocument class with customizations for Excel 2003 and Word 2003. This class is provided by the Visual Studio 2005 Tools for Office Second Edition runtime.

Although the two versions of the ServerDocument class share much of the same functionality, there are differences in namespaces, assemblies, and members. For more information, see Understanding ServerDocument Differences.

The ServerDocument class is designed to work on computers that do not have Microsoft Office installed. Therefore, you typically use this class in projects that do not integrate with Microsoft Office, such as Console projects or Windows Forms projects, rather than Visual Studio Tools for Office projects.

For more information about the different versions of the Visual Studio Tools for Office runtime, see Visual Studio Tools for Office Runtime Overview.

Both versions of the ServerDocument class provide 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.

You can use members of the ServerDocument class to manage the Visual Studio Tools for Office customization for a document. For example, you can programmatically remove the customization from a document so that the document is no longer part of a Visual Studio Tools for Office customization.

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

The two versions of the ServerDocument class and the related classes that provide the object model for cached data (such as CachedDataHostItem and CachedDataItem) are defined in different assemblies and namespaces. In addition, some members and method overloads are provided in only one version of the class. You should be aware of these differences in the following scenarios:

• You want to migrate code that uses the ServerDocument class in the Visual Studio 2005 Tools for Office Second Edition runtime so that it works with Excel 2007 and Word 2007 solutions.

• You want to use the ServerDocument class in code that works with document-level customizations for both Microsoft Office 2003 and the 2007 Microsoft Office system.

For an example that demonstrates how to use both versions of the ServerDocument class in the same code, see How to: Write Code that Uses Both Versions of the ServerDocument Class.

Namespace and Assembly Differences

Member Differences

Tasks

Concepts

Reference