Метод SqlSyncMetadataStoreSerializer.SerializeReplicaMetadata

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

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

Синтаксис

'Декларация
Public Overrides Sub SerializeReplicaMetadata ( _
    idFormats As SyncIdFormatGroup, _
    replicaId As SyncId, _
    serializedFilePath As String, _
    compatibilityLevel As CompatibilityLevel _
)
'Применение
Dim instance As SqlSyncMetadataStoreSerializer
Dim idFormats As SyncIdFormatGroup
Dim replicaId As SyncId
Dim serializedFilePath As String
Dim compatibilityLevel As CompatibilityLevel

instance.SerializeReplicaMetadata(idFormats, replicaId, serializedFilePath, compatibilityLevel)

public override void SerializeReplicaMetadata (
    SyncIdFormatGroup idFormats,
    SyncId replicaId,
    string serializedFilePath,
    CompatibilityLevel compatibilityLevel
)

public:
virtual void SerializeReplicaMetadata (
    SyncIdFormatGroup^ idFormats, 
    SyncId^ replicaId, 
    String^ serializedFilePath, 
    CompatibilityLevel compatibilityLevel
) override

public void SerializeReplicaMetadata (
    SyncIdFormatGroup idFormats, 
    SyncId replicaId, 
    String serializedFilePath, 
    CompatibilityLevel compatibilityLevel
)

public override function SerializeReplicaMetadata (
    idFormats : SyncIdFormatGroup, 
    replicaId : SyncId, 
    serializedFilePath : String, 
    compatibilityLevel : CompatibilityLevel
)

Параметры

idFormats
Схема форматов идентификаторов для поставщика.

replicaId
Идентификатор реплики, для которой требуется сериализация метаданных.

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

compatibilityLevel
Значение CompatibilityLevel, которое определяет версию Sync Framework, для которой верны сериализованные метаданные. Например, если собственным форматом сериализации для набора знаний является Sync Framework 2.0, а в этом параметре указано значение Sync Framework 1.0, то сериализация значений этого знания будет производиться в формате 1.0. Если в значениях набора знаний используются какие-либо функции формата 2.0, которые не могут быть сериализованы в формате 1.0, то сериализация вызовет исключение InvalidSerializationVersionException.

Исключения

Тип исключения	Условие
ArgumentNullException	Обязательный параметр равен пустая ссылка (Nothing в Visual Basic).
ArgumentException	Параметр serializedFilePath содержит пустую строку; параметр serializationVersion имеет значение, отличное от SyncFrameworkVersion1 или WindowsSync.
SyncIdFormatMismatchException	Формат replicaId отличается от формата, указанного в idFormats.
SyncInvalidOperationException	Хранилище метаданных не открыто.
ExplicitTransactionRequiredException	Недоступна транзакция, в которой можно выполнить сериализацию метаданных.

Замечания

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

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

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

См. также

Справочник

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

Last updated on 2009-10-17