LoadChangeData-Methode

Wird beim Überschreiben in einer abgeleiteten Klasse von der Sync Framework-Laufzeit aufgerufen, um die Änderungsdaten für das Element mit dem angegebenen Schlüssel zu laden.

Namespace:  Microsoft.Synchronization.SimpleProviders
Assembly:  Microsoft.Synchronization.SimpleProviders (in Microsoft.Synchronization.SimpleProviders.dll)

Syntax

'Declaration
Public MustOverride Function LoadChangeData ( _
    keyAndExpectedVersion As ItemFieldDictionary, _
    changeUnitsToLoad As IEnumerable(Of SyncId), _
    recoverableErrorReportingContext As RecoverableErrorReportingContext _
) As Object
'Usage
Dim instance As SimpleSyncProvider
Dim keyAndExpectedVersion As ItemFieldDictionary
Dim changeUnitsToLoad As IEnumerable(Of SyncId)
Dim recoverableErrorReportingContext As RecoverableErrorReportingContext
Dim returnValue As Object

returnValue = instance.LoadChangeData(keyAndExpectedVersion, _
    changeUnitsToLoad, recoverableErrorReportingContext)

public abstract Object LoadChangeData(
    ItemFieldDictionary keyAndExpectedVersion,
    IEnumerable<SyncId> changeUnitsToLoad,
    RecoverableErrorReportingContext recoverableErrorReportingContext
)

public:
virtual Object^ LoadChangeData(
    ItemFieldDictionary^ keyAndExpectedVersion, 
    IEnumerable<SyncId^>^ changeUnitsToLoad, 
    RecoverableErrorReportingContext^ recoverableErrorReportingContext
) abstract

abstract LoadChangeData : 
        keyAndExpectedVersion:ItemFieldDictionary * 
        changeUnitsToLoad:IEnumerable<SyncId> * 
        recoverableErrorReportingContext:RecoverableErrorReportingContext -> Object 

public abstract function LoadChangeData(
    keyAndExpectedVersion : ItemFieldDictionary, 
    changeUnitsToLoad : IEnumerable<SyncId>, 
    recoverableErrorReportingContext : RecoverableErrorReportingContext
) : Object

Parameter

• keyAndExpectedVersion
  Typ: Microsoft.Synchronization.SimpleProviders. . :: . .ItemFieldDictionary
  Der Schlüssel und die erwarteten Versionseigenschaften des Elements, für das die Daten geladen werden. Der Anbieter muss eine vollständige Parallelitätsprüfung ausführen, um sicherzustellen, dass die Version des Elements am Ziel den in keyAndExpectedVersion gefundenen Werten entspricht. Wenn diese Überprüfung fehlschlägt, sollte der Anbieter mit einem RecoverableErrorReportingContext-Objekt einen behebbaren Fehler melden.

• changeUnitsToLoad
  Typ: System.Collections.Generic. . :: . .IEnumerable< (Of < ( <'SyncId> ) > ) >
  Ein SyncId-Objekt, das die Änderungseinheiten enthält, die für ein Element zu laden sind. Der Parameter sollte NULL (nicht leer) sein, wenn keine Änderungseinheiten angegeben sind.

• recoverableErrorReportingContext
  Typ: Microsoft.Synchronization.SimpleProviders. . :: . .RecoverableErrorReportingContext
  Ein RecoverableErrorReportingContext-Objekt, das zur Meldung von behebbaren Fehlern verwendet wird, die während der Versuche auftreten, ein Element zu aktualisieren.

Rückgabewert

Typ: System. . :: . .Object
Ein Objekt, das die Änderungsdaten für das Element mit dem angegebenen Schlüssel darstellt.

Hinweise

Sync Framework muss in der Lage sein, Elemente im Quellelementspeicher aufzulisten und zu erkennen, ob Elemente oder Änderungseinheiten geändert wurden. Anschließend müssen die geänderten Daten geladen werden, sodass diese für den Zielspeicher übernommen werden können. Die Änderungserkennung wird von der Sync Framework-Laufzeit durchgeführt, doch die Änderungsenumeration und das Laden der Daten sind speicherspezifisch und werden durch Implementieren von EnumerateItems (für vollständige Enumerationsanbieter) oder EnumerateChanges (für ankerbasierte Anbieter) und von LoadChangeData(ItemFieldCollection, IEnumerable<(Of <<'(SyncId>)>>), RecoverableErrorReportingContext) (für beide Anbietertypen) durchgeführt.

Beispiele

Im folgenden Codebeispiel wird ein Objekt zurückgegeben, das eine der Datenänderungen enthält, die von EnumerateItems oder EnumerateChanges aufgelistet wurde. Sync Framework ruft diese Methode auf, bis alle Änderungen geladen wurden. In der "Sync101 using Simple Sync Provider"-Anwendung, die im Sync Framework SDK und in der Code Gallery verfügbar ist, finden Sie diesen Code im Kontext einer vollständigen Anwendung.

public override object LoadChangeData(ItemFieldDictionary keyAndExpectedVersion, IEnumerable<SyncId> changeUnitsToLoad, RecoverableErrorReportingContext recoverableErrorReportingContext)
{
    IDictionary<uint, ItemField> expectedFields = (IDictionary<uint, ItemField>)keyAndExpectedVersion;
    ulong id = (ulong)expectedFields[CUSTOM_FIELD_ID].Value;
    return new ItemTransfer(id, _store.Get(id));
}

Public Overrides Function LoadChangeData(ByVal keyAndExpectedVersion As ItemFieldDictionary, ByVal changeUnitsToLoad As IEnumerable(Of SyncId), ByVal recoverableErrorReportingContext As RecoverableErrorReportingContext) As Object
    Dim expectedFields As IDictionary(Of UInteger, ItemField) = DirectCast(keyAndExpectedVersion, IDictionary(Of UInteger, ItemField))
    Dim id As ULong = CULng(expectedFields(CUSTOM_FIELD_ID).Value)
    Return New ItemTransfer(id, _store.[Get](id))
End Function

Siehe auch

Verweis

SimpleSyncProvider Klasse

SimpleSyncProvider-Member

Microsoft.Synchronization.SimpleProviders-Namespace