Sync Interface

  • Référence

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.

S’applique à