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
    提供程序的 ID 格式架构。
  • replicaId
    应序列化其元数据的副本的 ID。
  • serializedFilePath
    要将元数据序列化到的目标文件。
  • compatibilityLevel
    一个 CompatibilityLevel 值,该值指定序列化数据对哪个版本的 Sync Framework 有效。例如,如果本机知识序列化格式为 Sync Framework 2.0,但为此参数提供的值为 Sync Framework 1.0,则以 1.0 格式序列化知识值。如果知识值使用任何无法以 1.0 格式序列化的 2.0 功能,则序列化会引发 InvalidSerializationVersionException 异常。

异常

异常类型 条件

ArgumentNullException

必需的参数为 null 引用(在 Visual Basic 中为 Nothing)。

ArgumentException

serializedFilePath 是一个空字符串;serializationVersion 是 SyncFrameworkVersion1WindowsSync 以外的值。

SyncIdFormatMismatchException

replicaId 的格式不是 idFormats 指定的格式。

SyncInvalidOperationException

元数据存储区未打开。

ExplicitTransactionRequiredException

要在其中序列化元数据的事务不可用。

备注

调用此方法之前必须满足两个条件:

在未满足上述任一条件时调用此方法会导致出现异常。

请参阅

参考

SqlSyncMetadataStoreSerializer 类
SqlSyncMetadataStoreSerializer 成员
Microsoft.Synchronization.MetadataStorage 命名空间