Sync Interface

Définition

Espace de noms:

Microsoft.Office.Core

Assembly:

office.dll

Cet objet, membre ou énumération est déconseillé et n’est pas destiné à être utilisé dans votre code. Utilisez l’objet Sync pour gérer la synchronisation des copies locales et serveur d’un document partagé stocké dans un espace de travail de document Windows SharePoint Services.

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

Attributs

GuidAttribute

Implémente

_IMsoDispObj

Remarques

La propriété Sync de l’objet Document Microsoft Office Word 2003, de l’objet Workbook Microsoft Office Excel 2003 et de l’objet Microsoft Office PowerPoint 2003 Presentation renvoie un objet Sync .

La Status propriété retourne des informations importantes sur l’état actuel de la synchronisation. Utilisez la GetUpdate() méthode pour actualiser l’état de synchronisation. Utilisez les LastSyncTimepropriétés , ErrorTypeet WorkspaceLastChangedBy pour retourner des informations supplémentaires.

Pour plus d’informations Status sur les différences et les conflits qui peuvent exister entre les copies locales et les copies serveur des documents partagés, consultez la propriété .

Utilisez la PutUpdate() méthode pour enregistrer les modifications locales sur le serveur. Fermez et rouvrez le document pour extraire du serveur la version la plus récente lorsque aucune modification locale n'a été apportée. Utilisez la ResolveConflict(MsoSyncConflictResolutionType) méthode pour résoudre les différences entre les copies locales et les copies serveur, ou la OpenVersion(MsoSyncVersionType) méthode pour ouvrir une autre version avec la version locale actuellement ouverte du document.

Les méthodes GetUpdate, PutUpdate et ResolveConflict de l'objet Sync ne renvoient pas de code d'état, car elles accomplissent leurs tâches de façon asynchrone. L'objet Sync fournit des informations d'état importantes via un seul événement, auxquelles le développeur peut accéder via les événements d'application suivants :

L’événement Sync décrit ci-dessus retourne une MsoSyncEventType valeur.

Le modèle objet Sync est disponible que le partage et la synchronisation soient activés ou désactivés sur le document actif. La propriété Sync des objets Document, Workbook et Presentation ne renvoie pas Nothing lorsque le document actif n’est pas partagé ou que la synchronisation n’est pas activée. Utilisez la propriété Status pour déterminer si le document est partagé et si la synchronisation est activée.

Tous les problèmes de synchronisation de document ne génèrent pas d’erreur d’exécution récupérable. Après utilisation des méthodes de l'objet Sync, il est conseillé de vérifier la propriété Status ; si la propriété Status a pour valeur msoSyncStatusError, vérifiez la propriété ErrorType pour obtenir des informations supplémentaires sur le type d'erreur qui s'est produit.

Dans de nombreux cas, la meilleure façon de résoudre une condition d’erreur consiste à appeler la méthode GetUpdate . Par exemple, si un appel à PutUpdate entraîne une erreur, alors un appel à GetUpdate réinitialise l’état à msoSyncStatusLocalChanges.

Propriétés

Application	Renvoie un objet Application qui représente l’application conteneur de l’objet .
Creator	Renvoie un entier 32 bits qui indique l'application dans laquelle l'objet spécifié a été créé.
ErrorType	Retourne une constante qui indique le type de l’erreur de synchronisation de document la plus récente.
LastSyncTime	Retourne la date et l’heure de la dernière synchronisation de la copie locale du document actif avec la copie du serveur.
Parent	Renvoie l’objet Parent de l’objet spécifié.
Status	Retourne l’état de la synchronisation de la copie locale du document actif avec la copie du serveur.
WorkspaceLastChangedBy	Affiche le nom convivial de l’utilisateur qui a enregistré les dernières modifications apportées à la copie serveur d’un document partagé.

Méthodes

GetUpdate()	Compare la version locale d’un document partagé à la version sur le serveur.
OpenVersion(MsoSyncVersionType)	Ouvre une autre version du document partagé parallèlement à la version locale actuellement ouverte.
PutUpdate()	Met à jour la copie du document partagé hébergée sur le serveur à partir de la copie locale.
ResolveConflict(MsoSyncConflictResolutionType)	Cette méthode résout les conflits entre la copie locale et la copie sur le serveur d'un document partagé.
Unsuspend()	Reprend la synchronisation entre la copie locale et la copie d'un document partagé hébergée sur le serveur.