GetFullEnumerationChangeBatch-Methode

Ruft, wenn in einer abgeleiteten Klasse überschrieben, 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

abstract GetFullEnumerationChangeBatch : 
        batchSize:uint32 * 
        lowerEnumerationBound:SyncId * 
        knowledgeForDataRetrieval:SyncKnowledge * 
        changeDataRetriever:Object byref -> FullEnumerationChangeBatch 

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

Parameter

• batchSize
  Typ: System. . :: . .UInt32
  Die Anzahl von Änderungen, die der Änderungsbatch umfassen soll.

• lowerEnumerationBound
  Typ: Microsoft.Synchronization. . :: . .SyncId
  Die Untergrenze für Element-IDs. Diese Methode gibt Änderungen zurück, deren IDs größer als oder gleich diesem ID-Wert sind.

• knowledgeForDataRetrieval
  Typ: Microsoft.Synchronization. . :: . .SyncKnowledge
  Wenn dieses Wissensobjekt eine Elementänderung enthält, sind im Zielreplikat bereits Daten für dieses Element vorhanden.

• changeDataRetriever
  Typ: System. . :: . .Object%
  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

Typ: Microsoft.Synchronization. . :: . .FullEnumerationChangeBatch
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

Andere Ressourcen

Wiederherstellen eines veralteten Replikats