LoadChangeData 方法
在衍生類別中覆寫時，由 Sync Framework 執行階段呼叫，以便針對具有指定之索引鍵的項目載入變更資料。
命名空間： Microsoft.Synchronization.SimpleProviders
組件： Microsoft.Synchronization.SimpleProviders (在 Microsoft.Synchronization.SimpleProviders.dll 中)
語法
'宣告
Public MustOverride Function LoadChangeData ( _
keyAndExpectedVersion As ItemFieldDictionary, _
changeUnitsToLoad As IEnumerable(Of SyncId), _
recoverableErrorReportingContext As RecoverableErrorReportingContext _
) As Object
'用途
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
參數
- keyAndExpectedVersion
型別：Microsoft.Synchronization.SimpleProviders. . :: . .ItemFieldDictionary
載入資料之項目的索引鍵和預期的版本屬性。提供者必須執行開放式並行存取檢查，以便驗證目的地的項目版本會對應至 keyAndExpectedVersion 中找到的值。如果這項檢查失敗，提供者應該使用 RecoverableErrorReportingContext 物件來報告可復原的錯誤。
- changeUnitsToLoad
型別：System.Collections.Generic. . :: . .IEnumerable< (Of < ( <'SyncId> ) > ) >
包含要針對項目載入之變更單位的 SyncId 物件。如果沒有指定任何變更單位，此參數應該是 Null (非空白)。
- recoverableErrorReportingContext
型別：Microsoft.Synchronization.SimpleProviders. . :: . .RecoverableErrorReportingContext
用來報告嘗試更新項目期間所發生之可復原錯誤的 RecoverableErrorReportingContext 物件。
傳回值
型別：System. . :: . .Object
物件，表示具有指定之索引鍵之項目的變更資料。
備註
Sync Framework 必須能夠列舉來源項目存放區中的項目、偵測項目或變更單位是否已變更，然後載入變更的資料，好讓該資料可以套用到目的地存放區。變更偵測是由 Sync Framework 執行階段處理，但是變更列舉和資料載入則是依存放區而異，而且是透過實作 EnumerateItems (適用於完整列舉提供者) 或 EnumerateChanges (適用於以錨定為基礎的提供者) 及 LoadChangeData(ItemFieldCollection, IEnumerable<(Of <<'(SyncId>)>>), RecoverableErrorReportingContext) (適用於任何一種提供者類型) 來處理。
範例
下列程式碼範例會傳回一個物件，此物件包含 EnumerateItems 或 EnumerateChanges 所列舉的其中一項資料變更。Sync Framework 會呼叫這個方法，直到所有變更都已載入為止。若要在完整應用程式的內容中檢視這段程式碼，請參閱 Sync Framework SDK 及 Code Gallery 中的 "Sync101 using Simple Sync Provider" 應用程式。
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