Méthode ReplicaMetadata.GetChangeBatch

En cas de substitution dans une classe dérivée, obtient un lot de modifications qui contient les métadonnées d'élément pour les éléments qui ne sont pas contenus dans la connaissance spécifiée du fournisseur de destination.

Espace de noms: Microsoft.Synchronization.MetadataStorage
Assembly: Microsoft.Synchronization.MetadataStorage (dans microsoft.synchronization.metadatastorage.dll)

Syntaxe

'Déclaration
Public MustOverride Function GetChangeBatch ( _
    batchSize As UInteger, _
    destinationKnowledge As SyncKnowledge _
) As ChangeBatch
'Utilisation
Dim instance As ReplicaMetadata
Dim batchSize As UInteger
Dim destinationKnowledge As SyncKnowledge
Dim returnValue As ChangeBatch

returnValue = instance.GetChangeBatch(batchSize, destinationKnowledge)

public abstract ChangeBatch GetChangeBatch (
    uint batchSize,
    SyncKnowledge destinationKnowledge
)

public:
virtual ChangeBatch^ GetChangeBatch (
    unsigned int batchSize, 
    SyncKnowledge^ destinationKnowledge
) abstract

public abstract ChangeBatch GetChangeBatch (
    UInt32 batchSize, 
    SyncKnowledge destinationKnowledge
)

public abstract function GetChangeBatch (
    batchSize : uint, 
    destinationKnowledge : SyncKnowledge
) : ChangeBatch

Paramètres

• batchSize
  Taille du lot à créer.

• destinationKnowledge
  Connaissance du fournisseur de destination.

Valeur de retour

Lot de modifications qui contient les métadonnées d'élément pour les éléments qui ne sont pas contenus dans la connaissance spécifiée du fournisseur de destination.

Exceptions

Notes

Cette méthode aide un fournisseur de synchronisation à implémenter sa méthode GetChangeBatch.

Avant que les fournisseurs n'appellent cette méthode, ils doivent s'assurer que les versions dans le magasin des métadonnées reflètent toutes les modifications locales, y compris les suppressions. Cette opération est accomplie par le biais d'une passe de maintenance des métadonnées explicite pour énumérer des éléments et mettre à jour leurs métadonnées.

L'implémentation de cette classe qui est disponible via SqlMetadataStore ajoute des modifications au lot de modifications dans l'ordre de l'ID global.

L'implémentation de cette classe qui est disponible via SqlMetadataStore affecte à IsLastBatch la valeur true sur le lot de modifications retourné quand il n'y a plus de modifications à envoyer.

Remarques à l'attention des implémenteurs : Pour aider un fournisseur qui utilise un ordre d'ID global et a la capacité d'utiliser des plages, les modifications doivent être énumérées et ajoutées au lot de modifications en ordre d'ID global. La première modification dans le lot de modifications retourné démarre une nouvelle plage. S'il n'y a plus de modifications à envoyer après ce lot, la propriété IsLastBatch doit avoir la valeur true sur le lot de modifications retourné, sans quoi Sync Framework appellera encore la méthode GetChangeBatch pour récupérer un autre lot de modifications.

Exemple

L'exemple suivant implémente KnowledgeSyncProvider.GetChangeBatch en passant les paramètres à ReplicaMetadata.GetChangeBatch.

public override ChangeBatch GetChangeBatch(uint batchSize, SyncKnowledge destinationKnowledge, out object changeDataRetriever)
{
    // Return this object as the IChangeDataRetriever object that is called to retrieve item data.
    changeDataRetriever = this;

    // Use metadata storage service to get a batch of changes.
    return _ContactStore.ContactReplicaMetadata.GetChangeBatch(batchSize, destinationKnowledge);
}

Voir aussi

Référence

Classe ReplicaMetadata
Membres ReplicaMetadata
Espace de noms Microsoft.Synchronization.MetadataStorage