Метод 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