LoadChangeData méthode
En cas de substitution dans une classe dérivée, appelé par le runtime de Sync Framework pour charger les données de modification pour l'élément avec la clé spécifiée.
Espace de noms : Microsoft.Synchronization.SimpleProviders
Assembly : Microsoft.Synchronization.SimpleProviders (dans Microsoft.Synchronization.SimpleProviders.dll)
Syntaxe
'Déclaration
Public MustOverride Function LoadChangeData ( _
keyAndExpectedVersion As ItemFieldDictionary, _
changeUnitsToLoad As IEnumerable(Of SyncId), _
recoverableErrorReportingContext As RecoverableErrorReportingContext _
) As Object
'Utilisation
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
Paramètres
- keyAndExpectedVersion
Type : Microsoft.Synchronization.SimpleProviders. . :: . .ItemFieldDictionary
Propriétés de clé et de version attendue de l'élément pour lequel les données sont chargées. Le fournisseur doit effectuer un contrôle d'accès concurrentiel optimiste pour vérifier que la version de l'élément sur la destination correspond aux valeurs disponibles dans keyAndExpectedVersion. Si ce contrôle échoue, le fournisseur doit signaler une erreur récupérable à l'aide d'un objet RecoverableErrorReportingContext.
- changeUnitsToLoad
Type : System.Collections.Generic. . :: . .IEnumerable< (Of < ( <'SyncId> ) > ) >
Objet SyncId qui contient les unités de modification à charger pour un élément. Le paramètre doit être Null (non vide) si aucune unité de modification n'est spécifiée.
- recoverableErrorReportingContext
Type : Microsoft.Synchronization.SimpleProviders. . :: . .RecoverableErrorReportingContext
Objet RecoverableErrorReportingContext utilisé pour signaler des erreurs récupérables qui se produisent pendant les tentatives de mise à jour d'un élément.
Valeur de retour
Type : System. . :: . .Object
Objet qui représente les données de modification pour l'élément avec la clé spécifiée.
Notes
Sync Framework doit être en mesure d'énumérer des éléments dans le magasin d'éléments source, de détecter si des éléments ou des unités de modification ont changé, puis de charger les données modifiées afin qu'elles puissent être appliquées au magasin de destination. La détection des modifications est gérée par le runtime de Sync Framework, mais l'énumération des modifications et le chargement des données sont spécifiques au magasin et sont gérés en implémentant les méthodes EnumerateItems (pour les fournisseurs d'énumération complète) ou EnumerateChanges (pour les fournisseurs basés sur les ancres) et LoadChangeData(ItemFieldCollection, IEnumerable<(Of <<'(SyncId>)>>), RecoverableErrorReportingContext) (pour chaque type de fournisseur).
Exemples
L'exemple de code suivant retourne un objet qui contient l'une des modifications de données énumérées par EnumerateItems ou EnumerateChanges. Sync Framework appelle cette méthode jusqu'à ce que toutes les modifications aient été chargées. Pour consulter ce code dans le contexte d'une application complète, consultez l'application "Sync101 using Simple Sync Provider" qui est disponible dans le Kit de développement logiciel (SDK) Sync Framework et de 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