ReplicaMetadata.GetFullEnumerationChangeBatch-Methode

Ruft, wenn in einer abgeleiteten Klasse überschrieben, im Zuge einer vollständigen Enumeration einen Änderungsbatch mit Elementmetadaten für Elemente ab, deren IDs über oder auf der angegebenen Untergrenze liegen.

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

Syntax

'Declaration
Public MustOverride Function GetFullEnumerationChangeBatch ( _
    batchSize As UInteger, _
    lowerEnumerationBound As SyncId, _
    destinationKnowledge As SyncKnowledge _
) As FullEnumerationChangeBatch
'Usage
Dim instance As ReplicaMetadata
Dim batchSize As UInteger
Dim lowerEnumerationBound As SyncId
Dim destinationKnowledge As SyncKnowledge
Dim returnValue As FullEnumerationChangeBatch

returnValue = instance.GetFullEnumerationChangeBatch(batchSize, lowerEnumerationBound, destinationKnowledge)

public abstract FullEnumerationChangeBatch GetFullEnumerationChangeBatch (
    uint batchSize,
    SyncId lowerEnumerationBound,
    SyncKnowledge destinationKnowledge
)

public:
virtual FullEnumerationChangeBatch^ GetFullEnumerationChangeBatch (
    unsigned int batchSize, 
    SyncId^ lowerEnumerationBound, 
    SyncKnowledge^ destinationKnowledge
) abstract

public abstract FullEnumerationChangeBatch GetFullEnumerationChangeBatch (
    UInt32 batchSize, 
    SyncId lowerEnumerationBound, 
    SyncKnowledge destinationKnowledge
)

public abstract function GetFullEnumerationChangeBatch (
    batchSize : uint, 
    lowerEnumerationBound : SyncId, 
    destinationKnowledge : SyncKnowledge
) : FullEnumerationChangeBatch

Parameter

• batchSize
  Die Größe des zurückzugebenden Änderungsbatchs.

• lowerEnumerationBound
  Die Untergrenze für Element-IDs. Diese Methode sollte Änderungen zurückgeben, deren IDs größer als oder gleich diesem ID-Wert sind.

• destinationKnowledge
  Das Wissen des Zielanbieters.

Rückgabewert

Ein Änderungsbatch mit Elementmetadaten für Elemente, deren IDs über oder auf der angegebenen Untergrenze liegen.

Ausnahmen

Hinweise

Diese Methode ist bei der Implementierung der GetFullEnumerationChangeBatch-Methode für Synchronisierungsanbieter hilfreich. Diese Methode wird während der Wiederherstellung vergessenen Wissens aufgerufen.

Vor dem Aufrufen dieser Methode müssen Anbieter sicherstellen, dass die Versionen im Metadatenspeicher alle lokalen Änderungen, einschließlich Löschungen, berücksichtigen. Dies wird durch einen expliziten Metadatenverwaltungsdurchlauf erreicht, in dem Elemente aufgelistet und ihre Metadaten aktualisiert werden.

Die Implementierung dieser Klasse, die durch SqlMetadataStore zur Verfügung gestellt wird, fügt dem Änderungsbatch Änderungen geordnet nach der globalen ID hinzu.

Die Implementierung dieser Klasse, die durch SqlMetadataStore verfügbar ist, gibt auch diejenigen Elemente zurück, deren IDs unter lowerEnumerationBound liegen und die nicht in destinationKnowledge enthalten sind.

Die Implementierung dieser Klasse, die durch SqlMetadataStore zur Verfügung gestellt wird, legt IsLastBatch für den zurückgegebenen Änderungsbatch auf true fest, wenn keine zu sendenden Änderungen mehr vorhanden sind.

Hinweise für Implementierer: Diese Methode muss Änderungen, deren Element-ID größer oder gleich dem Wert lowerEnumerationBound ist, sortiert nach Element-ID auflisten. Dadurch kann Sync Framework bestimmen, welche Elemente des Zielanbieters gelöscht, jedoch vom Quellenanbieter vergessen wurden. Wenn nach diesem Batch keine zu sendenden Änderungen mehr vorliegen, muss IsLastBatch für den zurückgegebenen Änderungsbatch auf true festgelegt werden. Andernfalls ruft Sync Framework erneut GetChangeBatch auf, um einen weiteren Änderungsbatch abzurufen. Bei einem Anbieter, der Elementdaten zusammen mit Metadaten für Elementänderungen sendet, kann mithilfe von destinationKnowledge bestimmt werden, ob es erforderlich ist, Elementdaten zu senden. Elementdaten müssen nicht gesendet werden, wenn die Elementänderung in destinationKnowledge enthalten ist.

Siehe auch

Verweis

ReplicaMetadata-Klasse
ReplicaMetadata-Member
Microsoft.Synchronization.MetadataStorage-Namespace