IChangeDataRetriever.LoadChangeData メソッド

派生クラスでオーバーライドされると、このメソッドは変更の項目データを取得します。

名前空間: Microsoft.Synchronization
アセンブリ: Microsoft.Synchronization (microsoft.synchronization.dll 内)

構文

'宣言
Function LoadChangeData ( _
    loadChangeContext As LoadChangeContext _
) As Object
'使用
Dim instance As IChangeDataRetriever
Dim loadChangeContext As LoadChangeContext
Dim returnValue As Object

returnValue = instance.LoadChangeData(loadChangeContext)

Object LoadChangeData (
    LoadChangeContext loadChangeContext
)

Object^ LoadChangeData (
    LoadChangeContext^ loadChangeContext
)

Object LoadChangeData (
    LoadChangeContext loadChangeContext
)

function LoadChangeData (
    loadChangeContext : LoadChangeContext
) : Object

パラメーター

• loadChangeContext
  データが取得される変更を説明するメタデータです。

戻り値

変更の項目データです。

解説

同期元プロバイダーは、このメソッドによって返されるオブジェクトの種類を決定します。このオブジェクトは、ボックス値の型のように簡単である場合も、高度なデータ取得のためのメソッドを含むクラスのように複雑である場合もあります。

例

次の例では、指定した変更単位のセットのデータを取得する LoadChangeData メソッドを実装します。この例では、一部の要素のみに値が設定された文字列の配列としてデータを返します。

Public Function LoadChangeData(ByVal loadChangeContext As LoadChangeContext) As Object Implements IChangeDataRetriever.LoadChangeData
    ' Sanity check to ensure the data array is not overrun.
    If Contact.ChangeUnitFieldCount < loadChangeContext.ItemChange.ChangeUnitChanges.Count Then
        Throw New ArgumentOutOfRangeException("LoadChangeData received too many change unit changes.")
    End If

    ' Get the ID of the item to return.
    Dim itemId As SyncId = loadChangeContext.ItemChange.ItemId

    ' Create a string array to hold the data for each change unit. Some of the elements of this array
    ' may be empty.
    Dim contactData As String() = New String(Contact.ChangeUnitFieldCount - 1) {}

    ' Enumerate the change units to retrieve.
    For iChange As Integer = 0 To loadChangeContext.ItemChange.ChangeUnitChanges.Count - 1
        ' Retrieve data for the specified change unit and put the data into the appropriate
        ' place in the string array.
        Dim icu As Integer = loadChangeContext.ItemChange.ChangeUnitChanges(iChange).ChangeUnitId.GetByteId()
        contactData(icu) = _ContactStore.GetContactData(itemId, loadChangeContext.ItemChange.ChangeUnitChanges(iChange).ChangeUnitId)
    Next
    Return contactData
End Function

public object LoadChangeData(LoadChangeContext loadChangeContext)
{
    // Sanity check to ensure the data array is not overrun.
    if (Contact.ChangeUnitFieldCount < loadChangeContext.ItemChange.ChangeUnitChanges.Count)
    {
        throw new ArgumentOutOfRangeException("LoadChangeData received too many change unit changes.");
    }

    // Get the ID of the item to return.
    SyncId itemId = loadChangeContext.ItemChange.ItemId;

    // Create a string array to hold the data for each change unit. Some of the elements of this array
    // may be empty.
    string[] contactData = new string[Contact.ChangeUnitFieldCount];

    // Enumerate the change units to retrieve.
    for (int iChange = 0; iChange < loadChangeContext.ItemChange.ChangeUnitChanges.Count; iChange++)
    {
        // Retrieve data for the specified change unit and put the data into the appropriate
        // place in the string array.
        int icu = loadChangeContext.ItemChange.ChangeUnitChanges[iChange].ChangeUnitId.GetByteId();
        contactData[icu] = _ContactStore.GetContactData(itemId,
            loadChangeContext.ItemChange.ChangeUnitChanges[iChange].ChangeUnitId);
    }
    return contactData;
}

参照

リファレンス

IChangeDataRetriever インターフェイス
IChangeDataRetriever メンバー
Microsoft.Synchronization 名前空間