Metodo ReplicaMetadata.GetFullEnumerationChangeBatch

Quando sottoposto a override in una classe derivata, ottiene un batch di modifiche contenente i metadati dell'elemento per gli elementi con ID uguali o maggiori del limite inferiore specificato, come parte di un'enumerazione completa.

Spazio dei nomi: Microsoft.Synchronization.MetadataStorage
Assembly: Microsoft.Synchronization.MetadataStorage (in microsoft.synchronization.metadatastorage.dll)

Sintassi

'Dichiarazione
Public MustOverride Function GetFullEnumerationChangeBatch ( _
    batchSize As UInteger, _
    lowerEnumerationBound As SyncId, _
    destinationKnowledge As SyncKnowledge _
) As FullEnumerationChangeBatch
'Utilizzo
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

Parametri

• batchSize
  Dimensione del batch di modifiche da restituire.

• lowerEnumerationBound
  Limite inferiore per gli ID elemento. Questo metodo deve restituire le modifiche con ID maggiori o uguali a questo valore di ID.

• destinationKnowledge
  Conoscenza del provider di destinazione.

Valore restituito

Batch di modifiche contenente metadati dell'elemento per gli elementi con ID uguali o maggiori del limite inferiore specificato.

Eccezioni

Osservazioni

Questo metodo consente a un provider di sincronizzazione di implementare il relativo metodo GetFullEnumerationChangeBatch. Questo metodo viene chiamato durante il recupero della conoscenza dimenticata.

Prima di chiamare questo metodo, i provider devono assicurarsi che le versioni nell'archivio dei metadati riflettano tutte le modifiche locali, incluse le eliminazioni. Questo risultato si ottiene tramite un passaggio esplicito di manutenzione dei metadati per enumerare gli elementi e aggiornare i relativi metadati.

L'implementazione di questa classe disponibile tramite SqlMetadataStore aggiunge modifiche al batch di modifiche nell'ordine ID globale.

L'implementazione di questa classe, disponibile tramite SqlMetadataStore, restituisce anche tutti gli elementi con ID minori di lowerEnumerationBound che non sono contenuti in destinationKnowledge.

L'implementazione di questa classe disponibile tramite SqlMetadataStore imposta IsLastBatch su true sul batch di modifiche restituito quando non sono più disponibili modifiche da inviare.

Note per gli implementatori: Questo metodo deve enumerare, ordinandole per ID elemento, le modifiche con ID elemento uguale a lowerEnumerationBound o maggiore. In questo modo, Sync Framework è in grado di determinare quali elementi nel provider di destinazione sono stati eliminati, ma dimenticati dal provider di origine. Se non sono disponibili altre modifiche da inviare dopo questo batch, è necessario impostare IsLastBatch su true nel batch di modifiche restituite. In caso contrario, Sync Framework eseguirà una nuova chiamata a GetChangeBatch per recuperare un altro batch di modifiche. Per un provider che invia i dati dell'elemento con i metadati della modifica dell'elemento, è possibile utilizzare destinationKnowledge per determinare se sia o meno necessario inviare i dati dell'elemento. Se la modifica dell'elemento è contenuta in destinationKnowledge, non è necessario inviare i dati dell'elemento.

Vedere anche

Riferimento

Classe ReplicaMetadata
Membri ReplicaMetadata
Spazio dei nomi Microsoft.Synchronization.MetadataStorage