Метод SqlSyncMetadataStoreSerializer.DeserializeReplicaMetadata

Выполняет десериализацию содержимого канонического файла метаданных в хранилище службы хранилища метаданных. Может обновлять формат хранилища метаданных при изменении версии поставщика.

Пространство имен: Microsoft.Synchronization.MetadataStorage
Сборка: Microsoft.Synchronization.MetadataStorage (в microsoft.synchronization.metadatastorage.dll)

Синтаксис

'Декларация
Public Overrides Function DeserializeReplicaMetadata ( _
    serializedFilePath As String, _
    expectedProviderCompatibilityVersion As UInteger, _
    providerUpgradeCallback As IProviderUpgradeCallback _
) As Boolean
'Применение
Dim instance As SqlSyncMetadataStoreSerializer
Dim serializedFilePath As String
Dim expectedProviderCompatibilityVersion As UInteger
Dim providerUpgradeCallback As IProviderUpgradeCallback
Dim returnValue As Boolean

returnValue = instance.DeserializeReplicaMetadata(serializedFilePath, expectedProviderCompatibilityVersion, providerUpgradeCallback)

public override bool DeserializeReplicaMetadata (
    string serializedFilePath,
    uint expectedProviderCompatibilityVersion,
    IProviderUpgradeCallback providerUpgradeCallback
)

public:
virtual bool DeserializeReplicaMetadata (
    String^ serializedFilePath, 
    unsigned int expectedProviderCompatibilityVersion, 
    IProviderUpgradeCallback^ providerUpgradeCallback
) override

public boolean DeserializeReplicaMetadata (
    String serializedFilePath, 
    UInt32 expectedProviderCompatibilityVersion, 
    IProviderUpgradeCallback providerUpgradeCallback
)

public override function DeserializeReplicaMetadata (
    serializedFilePath : String, 
    expectedProviderCompatibilityVersion : uint, 
    providerUpgradeCallback : IProviderUpgradeCallback
) : boolean

Параметры

• serializedFilePath
  Файл, который содержит сериализованные метаданные для данной реплики.

• expectedProviderCompatibilityVersion
  Версия совместимости поставщика, которая должна быть включена в канонический файл метаданных. Если ожидаемая версия не совпадает с текущей, то десериализация завершится ошибкой (если параметр providerUpgradeCallback равен пустая ссылка (Nothing в Visual Basic)) или будут вызваны методы providerUpgradeCallback (если параметр providerUpgradeCallback не равен пустая ссылка (Nothing в Visual Basic)). Дополнительные сведения см. в разделах Доступ к метаданным из компонентов с различными версиями и Обновление версии хранилища метаданных.

• providerUpgradeCallback
  Методы обратного вызова, которые вызываются при необходимости обновления формата хранилища метаданных, поскольку версия поставщика, указанная в сериализованных метаданных, не совпадает со значением expectedProviderCompatibilityVersion.

Возвращаемое значение

Значение true, когда есть метаданные для десериализации, в противном случае значение false.

Исключения

Замечания

Вызов этого метода возможен при соблюдении трех условий.

• Хранилище метаданных должно быть открыто. Открыть хранилище можно вызовом метода OpenStore или CreateStore.

• Хранилище метаданных реплики, для которой десериализуются данные, должно быть уже инициализировано. Чтобы инициализировать хранилище метаданных, вызовите метод InitializeReplicaMetadata.

• Для объекта SqlMetadataStore должна быть доступна активная транзакция. Начать транзакцию можно вызовом метода BeginTransaction.

Вызов этого метода в случае, если не выполняется какое-либо из этих условий, приводит к формированию исключения.

Этот метод может быть использован в составе процедуры обновления схемы метаданных при изменении версии поставщика. Дополнительные сведения см. в разделе Обновление версии хранилища метаданных.

См. также

Справочник

Класс SqlSyncMetadataStoreSerializer
Элементы SqlSyncMetadataStoreSerializer
Пространство имен Microsoft.Synchronization.MetadataStorage