LoadChangeData Método

Cuando se invalida en una clase derivada, lo llama el tiempo de ejecución de Sync Framework para cargar los datos de cambio para el elemento con la clave especificada.

Espacio de nombres:  Microsoft.Synchronization.SimpleProviders
Ensamblado:  Microsoft.Synchronization.SimpleProviders (en Microsoft.Synchronization.SimpleProviders.dll)

Sintaxis

'Declaración
Public MustOverride Function LoadChangeData ( _
    keyAndExpectedVersion As ItemFieldDictionary, _
    changeUnitsToLoad As IEnumerable(Of SyncId), _
    recoverableErrorReportingContext As RecoverableErrorReportingContext _
) As Object
'Uso
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

Parámetros

• keyAndExpectedVersion
  Tipo: Microsoft.Synchronization.SimpleProviders. . :: . .ItemFieldDictionary
  Propiedades de clave y de versión esperada del elemento para el que se cargan los datos. El proveedor debe realizar una comprobación de simultaneidad optimista para comprobar que la versión del elemento del destino se corresponde con los valores de keyAndExpectedVersion. Si se produce un error de la comprobación, el proveedor debe notificar un error recuperable utilizando un objeto RecoverableErrorReportingContext.

• changeUnitsToLoad
  Tipo: System.Collections.Generic. . :: . .IEnumerable< (Of < ( <'SyncId> ) > ) >
  Objeto SyncId que contiene las unidades de cambio que se van a cargar para un elemento. El parámetro debe ser nulo (no vacío) si no se especifica ninguna unidad de cambio.

• recoverableErrorReportingContext
  Tipo: Microsoft.Synchronization.SimpleProviders. . :: . .RecoverableErrorReportingContext
  Objeto RecoverableErrorReportingContext que se utiliza para notificar errores recuperables que se producen al intentar actualizar un elemento.

Valor devuelto

Tipo: System. . :: . .Object
Objeto que representa los datos de cambio para el elemento con la clave especificada.

Notas

Sync Framework debe poder enumerar los elementos del almacén de elementos de origen, detectar si se han modificado los elementos o las unidades de cambio y, a continuación, cargar los datos modificados para que puedan aplicarse al almacén de destino. La detección de cambios se administra mediante el tiempo de ejecución de Sync Framework, pero la enumeración de los cambios y la carga de datos son específicas del almacén y se administran en los proveedores de enumeración completa mediante la implementación de EnumerateItems (para proveedores de enumeración completa) o EnumerateChanges (para proveedores basados en delimitadores) y LoadChangeData(ItemFieldCollection, IEnumerable<(Of <<'(SyncId>)>>), RecoverableErrorReportingContext) (para cualquiera de los proveedores anteriores).

Ejemplos

En el ejemplo de código siguiente se devuelve un objeto que contiene uno de los cambios de datos enumerados por EnumerateItems o EnumerateChanges. Sync Framework llama a este método hasta que se cargan todos los cambios. Para consultar este código en el contexto de una aplicación completa, vea la aplicación "Sync101 using Simple Sync Provider" que está disponible en Sync Framework SDK y en Code Gallery.

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

Vea también

Referencia

SimpleSyncProvider Clase

SimpleSyncProvider Miembros

Microsoft.Synchronization.SimpleProviders Espacio de nombres