Verwalten von Dokumenten auf einem Server mithilfe der ServerDocument-Klasse
Sie können die ServerDocument Klasse in der Visual Studio-Tools für Office-Laufzeit verwenden, um mehrere Aspekte der Anpassungen auf Dokumentebene zu verwalten, auch 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 zwischengespeicherten Daten im Dokument.
Verwalten der Anpassungsassembly, die einem Dokument zugeordnet ist. Weitere Informationen finden Sie unter Verwalten der Dokumentanpassung.
Gilt für: Die Informationen in diesem Thema gelten für Projekte auf Dokumentebene für Excel und Word. Weitere Informationen finden Sie unter features available by Office-App lication and project type.
Grundlegendes zur ServerDocument-Klasse
Die ServerDocument-Klasse kann auf Computern verwendet werden, auf denen Office nicht installiert ist. Daher wird diese Klasse üblicherweise in Anwendungen verwendet, die nicht in Office integriert sind, z. B. Konsolenprojekte oder Windows Forms-Projekte, im Gegensatz zu Office-Projekten. Verwenden Sie die ServerDocument Klasse in der Assembly "Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll ".
Die ServerDocument Klasse kann zum Arbeiten mit Anpassungen auf Dokumentebene verwendet werden, die mit Visual Studio 2013 erstellt wurden.
Weitere Informationen zu den Visual Studio 2010-Tools für Office-Runtime und den Office-Erweiterungen für .NET Framework finden Sie unter Visual Studio-Tools Für Office-Laufzeitübersicht.
Hinweis
Wenn Sie über eine Ältere Anwendung verfügen, die die ServerDocument Klasse im Visual Studio Tools for Office System (Version 3.0 Runtime) verwendet, muss das Visual Studio Tools for Office System (Version 3.0 Runtime) auf Computern installiert sein, auf denen die Anwendung ausgeführt wird. Diese Visual Studio 2010 Tools for Office runtime Anwendungen können nicht ausgeführt werden.
Arbeiten mit zwischengespeicherten Daten im Dokument
Die ServerDocument-Klasse stellt Member bereit, die Sie verwenden können, um mit dem Datencache in angepassten Dokumenten zu arbeiten. Weitere Informationen zu zwischengespeicherten Daten finden Sie unter Zwischenspeichern von Daten und Access-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 | Zu verwendender Member |
|---|---|
| Bestimmen, ob ein Dokument über einen Datencache verfügt | Die IsCacheEnabled -Methode. |
| Zugreifen auf die zwischengespeicherten Daten in einem Dokument Weitere Informationen finden Sie unter Access-Daten in Dokumenten auf dem Server. |
Die CachedData-Eigenschaft |
Verwalten der Dokumentanpassung
Sie können Member der ServerDocument-Klasse zum Verwalten der Anpassungsassembly verwenden, die einem Dokument zugeordnet ist. Sie können z. B. die Anpassung aus einem Dokument programmgesteuert entfernen, sodass das Dokument nicht mehr Teil einer Anpassung ist.
In der folgenden Tabelle werden die Member, mit denen Sie die Anpassungsassembly verwalten können, aufgeführt.
| Aufgabe | Zu verwendender Member |
|---|---|
| Ermitteln, ob ein Dokument Teil einer Anpassung auf Dokumentebene ist | Die GetCustomizationVersion -Methode. |
| So fügen Sie eine Anpassung programmgesteuert zur Laufzeit an ein Dokument an. Weitere Informationen finden Sie unter How to: Attach managed code extensions to documents |
Eine der AddCustomization-Methoden |
| Programmgesteuertes Entfernen einer Anpassung aus einem Dokument zur Laufzeit Weitere Informationen finden Sie unter How to: Remove managed code Extensions from documents. |
Die RemoveCustomization -Methode. |
| Abrufen der URL des Bereitstellungsmanifests, das dem Dokument zugeordnet ist | Die DeploymentManifestUrl-Eigenschaft |