Metodo KnowledgeSyncProvider.GetChangeBatch

Articolo
09/18/2009

Se sottoposto a override in una classe derivata, ottiene un batch di modifiche contenente i metadati per gli elementi non contenuti nella conoscenza specificata del provider di destinazione.

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

Sintassi

'Dichiarazione
Public MustOverride Function GetChangeBatch ( _
    batchSize As UInteger, _
    destinationKnowledge As SyncKnowledge, _
    <OutAttribute> ByRef changeDataRetriever As Object _
) As ChangeBatch
'Utilizzo
Dim instance As KnowledgeSyncProvider
Dim batchSize As UInteger
Dim destinationKnowledge As SyncKnowledge
Dim changeDataRetriever As Object
Dim returnValue As ChangeBatch

returnValue = instance.GetChangeBatch(batchSize, destinationKnowledge, changeDataRetriever)

public abstract ChangeBatch GetChangeBatch (
    uint batchSize,
    SyncKnowledge destinationKnowledge,
    out Object changeDataRetriever
)

public:
virtual ChangeBatch^ GetChangeBatch (
    unsigned int batchSize, 
    SyncKnowledge^ destinationKnowledge, 
    [OutAttribute] Object^% changeDataRetriever
) abstract

public abstract ChangeBatch GetChangeBatch (
    UInt32 batchSize, 
    SyncKnowledge destinationKnowledge, 
    /** @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.

destinationKnowledge
Conoscenza del provider di destinazione. È necessario eseguire il mapping di questa conoscenza chiamando MapRemoteKnowledgeToLocal sulla conoscenza di origine prima che possa essere utilizzata per l'enumerazione delle modifiche.

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 non contenuti nella conoscenza specificata del provider di destinazione. Non può essere riferimento Null (Nothing in Visual Basic)..

Osservazioni

La stessa modifica non viene visualizzata in più batch.

Se il numero di modifiche rimanenti è inferiore a quello specificato da batchSize, viene restituito un batch di dimensioni ridotte.

Questo metodo genera InvalidOperationException se viene chiamato quando non rimane alcuna modifica.

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 GetChangeBatch per recuperare un altro batch di modifiche.

Vedere anche

Riferimento

Classe KnowledgeSyncProvider
Membri KnowledgeSyncProvider
Spazio dei nomi Microsoft.Synchronization

Condividi tramite