Freigeben über


KnowledgeSyncProvider.GetFullEnumerationChangeBatch-Methode

Ruft beim Überschreiben in einer abgeleiteten Klasse als Teil einer vollständigen Enumeration einen Änderungsbatch mit Elementmetadaten für Elemente ab, deren IDs über der angegebenen Untergrenze liegen.

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

Syntax

'Declaration
Public MustOverride Function GetFullEnumerationChangeBatch ( _
    batchSize As UInteger, _
    lowerEnumerationBound As SyncId, _
    knowledgeForDataRetrieval As SyncKnowledge, _
    <OutAttribute> ByRef changeDataRetriever As Object _
) As FullEnumerationChangeBatch
'Usage
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.

Parameter

  • batchSize
    Die Anzahl von Änderungen, die der Änderungsbatch umfassen soll.
  • lowerEnumerationBound
    Die Untergrenze für Element-IDs. Diese Methode gibt Änderungen zurück, deren IDs größer als oder gleich diesem ID-Wert sind.
  • knowledgeForDataRetrieval
    Wenn dieses Wissenobjekt eine Elementänderung enthält, sind im Zielreplikat bereits Daten für dieses Element vorhanden.
  • 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, deren IDs über der angegebenen Untergrenze liegen, als Teil einer vollständigen Enumeration.

Hinweise

Diese Methode wird während der Wiederherstellung vergessenen Wissens von Sync Framework aufgerufen.

Diese Methode listet Änderungen, deren Element-ID gleich dem Wert lowerEnumerationBound oder größer ist, sortiert nach Element-ID auf. Dadurch kann Sync Framework bestimmen, welche Elemente des Zielanbieters gelöscht, jedoch vom Quellenanbieter vergessen wurden. Optional kann diese Methode dem Batch auch nach Element-ID sortierte Änderungen hinzufügen, deren Element-ID kleiner ist als lowerEnumerationBound und die nicht im Zielwissen enthalten sind.

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 GetFullEnumerationChangeBatch von Sync Framework erneut aufgerufen, um einen weiteren Änderungsbatch abzurufen. Bei einem Anbieter, der Elementdaten zusammen mit Metadaten für Elementänderungen sendet, kann mithilfe von knowledgeForDataRetrieval bestimmt werden, ob es erforderlich ist, Elementdaten zu senden. Elementdaten müssen nicht gesendet werden, wenn die Elementänderung in knowledgeForDataRetrieval enthalten ist.

Siehe auch

Verweis

KnowledgeSyncProvider-Klasse
KnowledgeSyncProvider-Member
Microsoft.Synchronization-Namespace

Konzepte

Wiederherstellen eines veralteten Replikats