Méthode ReplicaMetadata.GetFullEnumerationChangeBatch

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 dont les ID sont supérieurs ou égaux à la limite inférieure spécifiée, dans le cadre d'une énumération complète.

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

Syntaxe

'Déclaration
Public MustOverride Function GetFullEnumerationChangeBatch ( _
    batchSize As UInteger, _
    lowerEnumerationBound As SyncId, _
    destinationKnowledge As SyncKnowledge _
) As FullEnumerationChangeBatch
'Utilisation
Dim instance As ReplicaMetadata
Dim batchSize As UInteger
Dim lowerEnumerationBound As SyncId
Dim destinationKnowledge As SyncKnowledge
Dim returnValue As FullEnumerationChangeBatch

returnValue = instance.GetFullEnumerationChangeBatch(batchSize, lowerEnumerationBound, destinationKnowledge)

public abstract FullEnumerationChangeBatch GetFullEnumerationChangeBatch (
    uint batchSize,
    SyncId lowerEnumerationBound,
    SyncKnowledge destinationKnowledge
)

public:
virtual FullEnumerationChangeBatch^ GetFullEnumerationChangeBatch (
    unsigned int batchSize, 
    SyncId^ lowerEnumerationBound, 
    SyncKnowledge^ destinationKnowledge
) abstract

public abstract FullEnumerationChangeBatch GetFullEnumerationChangeBatch (
    UInt32 batchSize, 
    SyncId lowerEnumerationBound, 
    SyncKnowledge destinationKnowledge
)

public abstract function GetFullEnumerationChangeBatch (
    batchSize : uint, 
    lowerEnumerationBound : SyncId, 
    destinationKnowledge : SyncKnowledge
) : FullEnumerationChangeBatch

Paramètres

• batchSize
  Taille du lot de modifications à retourner.

• lowerEnumerationBound
  Limite inférieure pour les ID d'élément. Cette méthode doit retourner les modifications qui ont des ID supérieurs ou égaux à cette valeur d'ID.

• 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 ont des ID supérieurs ou égaux à la limite inférieure spécifiée.

Exceptions

Notes

Cette méthode aide un fournisseur de synchronisation à implémenter sa méthode GetFullEnumerationChangeBatch. Cette méthode est appelée pendant la récupération d'une connaissance oubliée.

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. Cela est accompli par le biais d'un 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 retourne aussi tous les éléments dont les ID sont inférieurs à lowerEnumerationBound et qui ne sont pas contenus dans destinationKnowledge.

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 : Cette méthode doit énumérer, en ordre trié par ID d'élément, les modifications ayant un ID d'élément égal à lowerEnumerationBound ou supérieur. Cela permet à Sync Framework de déterminer les éléments sur le fournisseur de destination qui ont été supprimés, mais ont été oubliés par le fournisseur de source. 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é ou Sync Framework appellera encore la méthode GetChangeBatch pour récupérer un autre lot de modifications. Pour un fournisseur qui envoie des données d'élément avec des métadonnées de modification d'élément, destinationKnowledge peut être utilisé pour déterminer s'il est nécessaire ou non d'envoyer des données d'élément. Il n'est pas nécessaire d'envoyer les données d'élément lorsque la modification d'élément est contenue dans destinationKnowledge.

Voir aussi

Référence

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