KnowledgeSyncProvider.GetChangeBatch-Methode

Artikel
09/18/2009

Ruft beim Überschreiben in einer abgeleiteten Klasse einen Änderungsbatch mit Elementmetadaten für Elemente ab, die nicht im angegebenen Wissen des Zielanbieters enthalten sind.

Namespace: Microsoft.Synchronization
Assembly: Microsoft.Synchronization (in microsoft.synchronization.dll)

Syntax

'Declaration
Public MustOverride Function GetChangeBatch ( _
    batchSize As UInteger, _
    destinationKnowledge As SyncKnowledge, _
    <OutAttribute> ByRef changeDataRetriever As Object _
) As ChangeBatch
'Usage
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.

Parameter

batchSize
Die Anzahl von Änderungen, die der Änderungsbatch umfassen soll.

destinationKnowledge
Das Wissen des Zielanbieters. Dieses Wissen muss durch Aufrufen von MapRemoteKnowledgeToLocal für das Quellwissen zugeordnet werden, bevor es für die Änderungsenumeration verwendet werden kann.

changeDataRetriever
Gibt ein Objekt zurück, mit dem Änderungsdaten abgerufen werden können. Hierbei kann es sich um ein IChangeDataRetriever-Objekt oder ein anbieterspezifisches Objekt handeln.

Rückgabewert

Ein Änderungsbatch mit Elementmetadaten für Elemente, die nicht im angegebenen Wissen des Zielanbieters enthalten sind. Darf nicht NULL sein.

Hinweise

Die gleiche Änderung ist nicht in mehreren Batches enthalten.

Wenn weniger Änderungen als die von batchSize angegebene Anzahl verbleiben, wird ein kleinerer Batch zurückgegeben.

Wenn diese Methode aufgerufen wird, obwohl keine Änderungen mehr vorhanden sind, wird InvalidOperationException ausgelöst.

Hinweise für Implementierer: Wenn nach diesem Batch keine zu sendenden Änderungen mehr vorliegen, muss IsLastBatch für den zurückgegebenen Änderungsbatch auf true festgelegt werden. Andernfalls wird GetChangeBatch von Sync Framework erneut aufgerufen, um einen weiteren Änderungsbatch abzurufen.

Siehe auch

Verweis

KnowledgeSyncProvider-Klasse
KnowledgeSyncProvider-Member
Microsoft.Synchronization-Namespace

Share via