Sync Schnittstelle

Definition

Namespace:

Microsoft.Office.Core

Assembly:

office.dll

Dieses Objekt, Dieses Element oder diese Enumeration ist veraltet und ist nicht für die Verwendung in Ihrem Code vorgesehen. Verwenden Sie das Sync-Objekt, um die Synchronisierung der lokalen Und Serverkopien eines freigegebenen Dokuments zu verwalten, das in einem Windows SharePoint Services Dokumentarbeitsbereich gespeichert ist.

public interface class Sync : Microsoft::Office::Core::_IMsoDispObj

[System.Runtime.InteropServices.Guid("000C0386-0000-0000-C000-000000000046")]
public interface Sync : Microsoft.Office.Core._IMsoDispObj

[<System.Runtime.InteropServices.Guid("000C0386-0000-0000-C000-000000000046")>]
type Sync = interface
    interface _IMsoDispObj

Public Interface Sync
Implements _IMsoDispObj

Attribute

GuidAttribute

Implementiert

_IMsoDispObj

Hinweise

Die Sync-Eigenschaft des Microsoft Office Word 2003 Document-Objekts , des Microsoft Office Excel 2003 Workbook-Objekts und des Microsoft Office PowerPoint 2003 Presentation-Objekts gibt ein Sync-Objekt zurück.

Die Status -Eigenschaft gibt wichtige Informationen zum aktuellen Status der Synchronisierung zurück. Verwenden Sie die GetUpdate() -Methode, um den Synchronisierungsstatus zu aktualisieren. Verwenden Sie die LastSyncTimeEigenschaften , ErrorTypeund WorkspaceLastChangedBy , um zusätzliche Informationen zurückzugeben.

Status Weitere Informationen zu den Unterschieden und Konflikten, die zwischen lokalen Kopien und Serverkopien von freigegebenen Dokumenten bestehen können, finden Sie in der -Eigenschaft.

Verwenden Sie die PutUpdate() -Methode, um lokale Änderungen auf dem Server zu speichern. Schließen Sie und erneut öffnen Sie das Dokument, um die neueste Version vom Server abzurufen, wenn keine lokalen Änderungen vorgenommen wurden. Verwenden Sie die ResolveConflict(MsoSyncConflictResolutionType) -Methode, um Unterschiede zwischen den lokalen Kopien und den Serverkopien aufzulösen, oder die OpenVersion(MsoSyncVersionType) -Methode, um eine andere Version neben der derzeit geöffneten lokalen Version des Dokuments zu öffnen.

Die Methoden GetUpdate, PutUpdate und ResolveConflict des Sync -Objekts geben nicht Statuscodes zurück, weil sie ihre Aufgaben asynchron ausführen. Das Sync -Objekt bietet wichtige Statusinformationen durch ein einzelnes Ereignis, das der Entwickler mithilfe der folgenden anwendungsspezifischen Ereignisse zugreifen kann:

Das oben beschriebene Sync-Ereignis gibt einen MsoSyncEventType Wert zurück.

Das Sync -Objektmodell ist verfügbar, ob Freigabe und Synchronisierung für das aktive Dokument deaktiviert oder aktiviert sind. Die Sync -Eigenschaft der Objekte Document, Workbook und Presentation gibt keine zurück Nothing zurück, wenn im aktive Dokument nicht freigegeben ist oder Synchronisierung ist nicht aktiviert. Verwenden Sie die Status -Eigenschaft, um zu bestimmen, ob das Dokument freigegeben ist und ob die Synchronisierung aktiviert ist.

Nicht alle Dokumentsynchronisierungsprobleme lösen abfangbare Laufzeitfehler aus. Nachdem Sie die Methoden des Sync-Objekts verwendet haben, sollten Sie die Status-Eigenschaft überprüfen. Wenn die Status-EigenschaftmsoSyncStatusError ist, überprüfen Sie die ErrorType-Eigenschaft auf zusätzliche Informationen zum Aufgetretenen Fehlertyp.

In vielen Fällen wird die beste Möglichkeit zum Beheben eines Fehlers die GetUpdate -Methode aufzurufen. Beispielsweise wird Wenn ein Aufruf von PutUpdate Ergebnisse in ein Fehlerzustand, klicken Sie dann ein Anruf an GetUpdate den Status msoSyncStatusLocalChanges zurückgesetzt.

Eigenschaften

Application	Gibt ein Application-Objekt zurück, das die Containeranwendung für das -Objekt darstellt.
Creator	Gibt eine 32-Bit-Ganzzahl, die die Anwendung angibt, in der das angegebene Objekt erstellt wurde.
ErrorType	Gibt eine Konstante zurück, die den Typ des letzten Dokumentsynchronisierungsfehlers angibt.
LastSyncTime	Gibt das Datum und die Uhrzeit der letzten Synchronisierung der lokalen Kopie des aktiven Dokuments mit der Serverkopie zurück.
Parent	Gibt das Parent-Objekt für das angegebene Objekt zurück.
Status	Gibt den Status der Synchronisierung der lokalen Kopie des aktiven Dokuments mit der Serverkopie zurück.
WorkspaceLastChangedBy	Zeigt den Anzeigenamen des Benutzers an, der zuletzt Änderungen an der Serverkopie eines freigegebenen Dokuments gespeichert hat.

Methoden

GetUpdate()	Vergleicht die lokale Version des freigegebenen Dokuments mit der Version auf dem Server.
OpenVersion(MsoSyncVersionType)	Öffnet eine andere Version des freigegebenen Dokuments zusätzlich zu der aktuell geöffneten lokalen Version.
PutUpdate()	Aktualisiert das Serverexemplar des freigegebenen Dokuments mit der lokalen Kopie.
ResolveConflict(MsoSyncConflictResolutionType)	Behebt Konflikte zwischen der lokalen Kopie und dem Serverexemplar eines freigegebenen Dokuments.
Unsuspend()	Setzt die Synchronisierung zwischen der lokalen Kopie und dem Serverexemplar eines freigegebenen Dokuments fort.