Metodo KnowledgeSyncProvider.GetFullEnumerationChangeBatch

Articolo
09/18/2009

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

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

Sintassi

'Dichiarazione
Public MustOverride Function GetFullEnumerationChangeBatch ( _
    batchSize As UInteger, _
    lowerEnumerationBound As SyncId, _
    knowledgeForDataRetrieval As SyncKnowledge, _
    <OutAttribute> ByRef changeDataRetriever As Object _
) As FullEnumerationChangeBatch
'Utilizzo
Dim instance As KnowledgeSyncProvider
Dim batchSize As UInteger
Dim lowerEnumerationBound As SyncId
Dim knowledgeForDataRetrieval As SyncKnowledge
Dim changeDataRetriever As Object
Dim returnValue As FullEnumerationChangeBatch

returnValue = instance.GetFullEnumerationChangeBatch(batchSize, lowerEnumerationBound, knowledgeForDataRetrieval, changeDataRetriever)

public abstract FullEnumerationChangeBatch GetFullEnumerationChangeBatch (
    uint batchSize,
    SyncId lowerEnumerationBound,
    SyncKnowledge knowledgeForDataRetrieval,
    out Object changeDataRetriever
)

public:
virtual FullEnumerationChangeBatch^ GetFullEnumerationChangeBatch (
    unsigned int batchSize, 
    SyncId^ lowerEnumerationBound, 
    SyncKnowledge^ knowledgeForDataRetrieval, 
    [OutAttribute] Object^% changeDataRetriever
) abstract

public abstract FullEnumerationChangeBatch GetFullEnumerationChangeBatch (
    UInt32 batchSize, 
    SyncId lowerEnumerationBound, 
    SyncKnowledge knowledgeForDataRetrieval, 
    /** @attribute OutAttribute() */ /** @ref */ Object changeDataRetriever
)

JScript does not support passing value-type arguments by reference.

Parametri

batchSize
Numero di modifiche da includere nel batch di modifiche.

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

knowledgeForDataRetrieval
Se in questo oggetto conoscenza è presente una modifica dell'elemento, i dati per tale elemento esistono già nella replica di destinazione.

changeDataRetriever
Restituisce un oggetto che può essere utilizzato per recuperare i dati di modifica. Può essere un oggetto IChangeDataRetriever o un oggetto specifico del provider.

Valore restituito

Batch di modifiche contenente i metadati per gli elementi con ID maggiori del limite inferiore specificato, come parte di un'enumerazione completa.

Osservazioni

Questo metodo viene chiamato da Sync Framework durante il recupero della conoscenza dimenticata.

Questo metodo enumera, in base al criterio di ordinamento per ID elemento, le modifiche con ID elemento superiore o uguale a lowerEnumerationBound. In questo modo Sync Framework è in grado di determinare quali elementi sul provider di destinazione sono stati eliminati ma dimenticati dal provider di origine. Se lo si desidera, questo metodo consente anche di aggiungere modifiche al batch, ordinate per ID elemento, con ID inferiori a lowerEnumerationBound e che non sono contenute nella conoscenza della destinazione.

Note per gli implementatori: Se non sono disponibili altre modifiche da inviare dopo questo batch, è necessario impostare IsLastBatch su true sul batch di modifiche restituito. In caso contrario, Sync Framework chiama nuovamente GetFullEnumerationChangeBatch per recuperare un altro batch di modifiche. Per un provider che invia i dati dell'elemento insieme ai metadati della modifica dell'elemento, è possibile utilizzare knowledgeForDataRetrieval per determinare se sia o meno necessario inviare i dati dell'elemento. Se la modifica dell'elemento è contenuta in knowledgeForDataRetrieval, non è necessario inviare i dati dell'elemento.

Vedere anche

Riferimento

Classe KnowledgeSyncProvider
Membri KnowledgeSyncProvider
Spazio dei nomi Microsoft.Synchronization

Concetti

Recupero di una replica non aggiornata

Condividi tramite