Verwalten von Dokumenten auf einem Server mit der ServerDocument-Klasse
Aktualisiert: November 2007
Betrifft |
|---|
Die Informationen in diesem Thema gelten nur für die angegebenen Projekte und Versionen von Visual Studio Tools for Office von Microsoft Office. Projekttyp
Microsoft Office-Version
Weitere Informationen hierzu finden Sie unter Verfügbare Features nach Anwendung und Projekttyp. |
Mit der ServerDocument-Klasse können Sie mehrere Aspekte von Anpassungen auf Dokumentebene verwalten, selbst wenn Microsoft Office Word und Microsoft Office Excel nicht installiert sind. Sie können die folgenden Aufgaben ausführen:
Zugreifen auf und Ändern von Daten im Datencache eines Dokuments oder einer Arbeitsmappe. Weitere Informationen finden Sie unter Arbeiten mit im Dokument zwischengespeicherten Daten.
Verwalten der Visual Studio Tools for Office-Anpassung für ein Dokument. Weitere Informationen finden Sie unter Verwalten der Dokumentanpassung.
Die ServerDocument-Klasse
Es gibt zwei verschiedene Versionen der ServerDocument-Klasse, für jede Version der Visual Studio Tools for Office-Laufzeit jeweils eine. Verwenden Sie die Version, die der Version der Projektmappe von Microsoft Office entspricht:
Verwenden Sie die Microsoft.VisualStudio.Tools.Applications.ServerDocument-Klasse mit Anpassungen für Excel 2007 und Word 2007. Diese Klasse wird von Microsoft Visual Studio Tools für Microsoft Office System (Version 3.0-Laufzeit) bereitgestellt.
Verwenden Sie die Microsoft.VisualStudio.Tools.Applications.Runtime.ServerDocument-Klasse mit Anpassungen für Excel 2003 und Word 2003. Diese Klasse wird von Laufzeit für Visual Studio 2005 Tools for Office Second Edition bereitgestellt.
Obwohl den zwei Versionen der ServerDocument-Klasse viele Funktionen gemeinsam sind, gibt es Unterschiede bei Namespaces, Assemblys und Membern. Weitere Informationen finden Sie unter Unterschiede bei ServerDocument.
Die ServerDocument-Klasse kann auf Computern verwendet werden, auf denen Microsoft Office nicht installiert ist. Daher wird diese Klasse üblicherweise in Projekten verwendet, die nicht in Microsoft Office integriert sind, z. B. Konsolenprojekte oder Windows Forms-Projekte, im Gegensatz zu Visual Studio Tools for Office-Projekten.
Weitere Informationen zu den unterschiedlichen Versionen der Visual Studio Tools for Office-Laufzeit finden Sie unter Übersicht über die Visual Studio Tools for Office-Laufzeit.
Arbeiten mit im Dokument zwischengespeicherten Daten
Beide Versionen der ServerDocument-Klasse stellen Member bereit, die Sie verwenden können, um mit dem Datencache in angepassten Dokumenten zu arbeiten. Weitere Informationen über zwischengespeicherte Daten finden Sie unter Zwischenspeichern von Daten und unter Zugreifen auf Daten in Dokumenten auf dem Server.
In der folgenden Tabelle werden die Member aufgeführt, die Sie verwenden können, um mit zwischengespeicherten Daten zu arbeiten.
Aufgabe |
Excel 2007- und Word 2007-Projekte |
Excel 2003- und Word 2003-Projekte |
|---|---|---|
Bestimmen, ob ein Dokument über einen Visual Studio Tools for Office-Datencache verfügt |
Die IsCacheEnabled-Methode in Microsoft Visual Studio Tools für Microsoft Office System (Version 3.0-Laufzeit) |
Die IsCacheEnabled-Methode in Laufzeit für Visual Studio 2005 Tools for Office Second Edition |
Zugreifen auf die zwischengespeicherten Daten in einem Dokument Weitere Informationen hierzu finden Sie unter Zugreifen auf Daten in Dokumenten auf dem Server. |
Die CachedData-Eigenschaft in Microsoft Visual Studio Tools für Microsoft Office System (Version 3.0-Laufzeit) |
Die CachedData-Eigenschaft in Laufzeit für Visual Studio 2005 Tools for Office Second Edition |
Verwalten der Dokumentanpassung
Sie können mit Membern der ServerDocument-Klasse die Visual Studio Tools for Office-Anpassung für ein Dokument verwalten. Sie können z. B. die Anpassung aus einem Dokument programmgesteuert entfernen, sodass das Dokument nicht mehr Teil einer Visual Studio Tools for Office-Anpassung ist.
In der folgenden Tabelle werden die Member, mit denen Sie die Anpassungsassembly verwalten können, aufgeführt.
Aufgabe |
Excel 2007- und Word 2007-Projekte |
Excel 2003- und Word 2003-Projekte |
|---|---|---|
Bestimmen, ob ein Dokument über eine Visual Studio Tools for Office-Anpassung verfügt |
Die GetCustomizationVersion-Methode in Microsoft Visual Studio Tools für Microsoft Office System (Version 3.0-Laufzeit) |
Die IsCustomized-Methode in Laufzeit für Visual Studio 2005 Tools for Office Second Edition |
Programmgesteuertes Anfügen einer Anpassung an ein Dokument zur Laufzeit Weitere Informationen finden Sie unter folgenden Themen: |
Eine der AddCustomization-Methoden in Microsoft Visual Studio Tools für Microsoft Office System (Version 3.0-Laufzeit) |
Eine der AddCustomization-Methoden in Laufzeit für Visual Studio 2005 Tools for Office Second Edition |
Programmgesteuertes Entfernen einer Anpassung aus einem Dokument zur Laufzeit Weitere Informationen finden Sie unter folgenden Themen: |
Die RemoveCustomization-Methode in Microsoft Visual Studio Tools für Microsoft Office System (Version 3.0-Laufzeit) |
Die RemoveCustomization-Methode in Laufzeit für Visual Studio 2005 Tools for Office Second Edition |
Abrufen der URL des Bereitstellungsmanifests, das dem Dokument zugeordnet ist |
Die DeploymentManifestUrl-Eigenschaft in Microsoft Visual Studio Tools für Microsoft Office System (Version 3.0-Laufzeit) |
Laufzeit für Visual Studio 2005 Tools for Office Second Edition enthält diese Eigenschaft nicht, da das Bereitstellungsmanifest bei Projektmappen auf Dokumentebene für Excel 2003 und Word 2003 optional ist. Stattdessen verfügen diese Projektmappen immer über ein eingebettetes Anwendungsmanifest. |
Zugreifen auf das Anwendungsmanifest, das im Dokument eingebettet ist |
Microsoft Visual Studio Tools für Microsoft Office System (Version 3.0-Laufzeit) enthält diese Eigenschaft nicht, da Projektmappen auf Dokumentebene für Excel 2007 und Word 2007 nicht über ein eingebettetes Anwendungsmanifest verfügen. |
Die AppManifest-Eigenschaft in Laufzeit für Visual Studio 2005 Tools for Office Second Edition |
Unterschiede bei ServerDocument
Die zwei Versionen der ServerDocument-Klasse und die zugehörigen Klassen, die das Objektmodell für zwischengespeicherte Daten bereitstellen (z. B. CachedDataHostItem und CachedDataItem) werden in unterschiedlichen Assemblys und Namespaces definiert. Außerdem werden einige Member und Methodenüberladungen nur in einer Version der Klasse bereitgestellt. Sie sollten diese Unterschiede in den folgenden Szenarien beachten:
Sie möchten Code migrieren, der die ServerDocument-Klasse in Laufzeit für Visual Studio 2005 Tools for Office Second Edition verwendet, sodass er mit Excel 2007- und Word 2007-Projektmappen funktioniert.
Sie möchten die ServerDocument-Klasse in Code verwenden, der mit Anpassungen auf Dokumentebene für Microsoft Office 2003 und 2007 Microsoft Office System funktioniert.
Ein Beispiel, das veranschaulicht, wie beide Versionen der ServerDocument-Klasse im gleichen Code verwendet werden können, finden Sie unter Gewusst wie: Schreiben von Code, der beide Versionen der ServerDocument-Klasse verwendet.
Unterschiede bei Namespace und Assembly
In der folgenden Tabelle werden die Unterschiede bei Namespace und Assembly in den zwei Versionen der ServerDocument-Klasse und den Klassen, die das Objektmodell für zwischengespeicherte Daten bereitstellen, aufgeführt.
Laufzeitversion |
Namespace |
Assembly |
|---|---|---|
Microsoft Visual Studio Tools für Microsoft Office System (Version 3.0-Laufzeit) |
Microsoft.VisualStudio.Tools.Applications.ServerDocument.v9.0.dll |
|
Laufzeit für Visual Studio 2005 Tools for Office Second Edition |
Microsoft.VisualStudio.Tools.Applications.Runtime.dll |
Unterschiede bei Membern
Die folgenden Member werden nur in der ServerDocument-Klasse in Microsoft Visual Studio Tools für Microsoft Office System (Version 3.0-Laufzeit) bereitgestellt:
Die folgenden Member werden nur in der ServerDocument-Klasse in Laufzeit für Visual Studio 2005 Tools for Office Second Edition bereitgestellt:
Siehe auch
Aufgaben
Gewusst wie: Schreiben von Code, der beide Versionen der ServerDocument-Klasse verwendet
Gewusst wie: Anfügen von verwalteten Codeerweiterungen an Dokumente (2007 System)
Gewusst wie: Anfügen von verwalteten Codeerweiterungen an Dokumente (2003 System)
Gewusst wie: Entfernen verwalteter Codeerweiterungen aus Dokumenten (2007 System)
Gewusst wie: Entfernen verwalteter Codeerweiterungen aus Dokumenten (2003 System)
Konzepte
Übersicht über die Visual Studio Tools for Office-Laufzeit
Referenz
Microsoft.VisualStudio.Tools.Applications.ServerDocument
Microsoft.VisualStudio.Tools.Applications.Runtime.ServerDocument