SyncDataConverter.TryConvertDataRetrieverToProviderFormat 方法

在衍生類別中覆寫時，會將資料擷取器從外部格式轉換成相關聯提供者的資料擷取器格式。

命名空間: Microsoft.Synchronization
組件: Microsoft.Synchronization (在 microsoft.synchronization.dll)

語法

'宣告
Public Overridable Function TryConvertDataRetrieverToProviderFormat ( _
    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.TryConvertDataRetrieverToProviderFormat(dataRetrieverIn, itemChanges, dataRetrieverOut)

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

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

public boolean TryConvertDataRetrieverToProviderFormat (
    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 以外的介面來擷取資料時，才需要使用這個方法。通常，轉換資料擷取器最有效率的方式就是建立 Proxy，以便實作提供者的資料擷取器介面並且保存外部資料擷取器介面的指標。然後，在同步處理工作階段期間處理變更時，此 Proxy 就可以從外部介面擷取資料。在某些情況下 (例如遠端變更套用案例)，您必須先擷取所有變更、視需要轉換它們，然後使用所有內部資料來序列化資料擷取器。針對這些情況，請使用 itemChanges 來列舉應該要序列化的所有變更。

如需資料轉換的詳細資訊，請參閱在提供者之間轉換資料。

請參閱

參考

SyncDataConverter 類別
SyncDataConverter 成員
Microsoft.Synchronization 命名空間