SyncDataConverter.TryConvertDataRetrieverFromProviderFormat メソッド

  • [アーティクル]

派生クラス内でオーバーライドされた場合、データ取得元を、関連付けられているプロバイダーの転送形式から必要なデータ取得元形式に変換します。

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

構文

'宣言
Public Overridable Function TryConvertDataRetrieverFromProviderFormat ( _
    dataRetrieverIn As Object, _
    itemChanges As IEnumerable(Of ItemChange), _
    <OutAttribute> ByRef dataRetrieverOut As Object _
) As Boolean
'使用
Dim instance As SyncDataConverter
Dim dataRetrieverIn As Object
Dim itemChanges As IEnumerable(Of ItemChange)
Dim dataRetrieverOut As Object
Dim returnValue As Boolean

returnValue = instance.TryConvertDataRetrieverFromProviderFormat(dataRetrieverIn, itemChanges, dataRetrieverOut)

public virtual bool TryConvertDataRetrieverFromProviderFormat (
    Object dataRetrieverIn,
    IEnumerable<ItemChange> itemChanges,
    out Object dataRetrieverOut
)

public:
virtual bool TryConvertDataRetrieverFromProviderFormat (
    Object^ dataRetrieverIn, 
    IEnumerable<ItemChange^>^ itemChanges, 
    [OutAttribute] Object^% dataRetrieverOut
)

public boolean TryConvertDataRetrieverFromProviderFormat (
    Object dataRetrieverIn, 
    IEnumerable<ItemChange> itemChanges, 
    /** @attribute OutAttribute() */ /** @ref */ Object dataRetrieverOut
)

JScript does not support passing value-type arguments by reference.

パラメーター

  • dataRetrieverIn
    変換するデータ取得元を表すオブジェクト。
  • itemChanges
    一連の項目変更を表す ItemChange オブジェクト。
  • dataRetrieverOut
    変換されたデータ取得元を表すオブジェクト。

戻り値

データ取得元の変換が成功した場合は true、それ以外の場合は false。

解説

このメソッドが必要になるのは、同期セッション内のプロバイダーの片方あるいは両方が IChangeDataRetriever 以外のインターフェイスを使用してデータを取得する場合に限られます。多くの場合、データ取得元を変換する最も効率的な方法は、必要なデータ取得元インターフェイスを実装するプロキシを作成し、プロバイダーのデータ取得元インターフェイスに対する参照を保持するという方法です。これにより、変更が同期セッション中に処理されるので、プロキシはプロバイダーのインターフェイスからデータを取得できるようになります。リモートの変更適用シナリオのように、すべての変更を最初に取得し、これらを必要に応じて変換して、すべてのデータを含めてデータ取得元をシリアル化する必要が生じる場合もあります。このような場合には、itemChanges を使用して、シリアル化する必要があるすべての変更を列挙します。

データ変換の詳細については、「プロバイダー間でのデータの変換」を参照してください。

参照

リファレンス

SyncDataConverter クラス
SyncDataConverter メンバー
Microsoft.Synchronization 名前空間