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 格式序列化知識值。如果知識值使用任何無法以 1.0 格式序列化的 2.0 功能，序列化就會擲回 InvalidSerializationVersionException 例外狀況。

例外

例外狀況型別	條件
ArgumentNullException	必要的參數為 null 參考 (在 Visual Basic 中為 Nothing)。
ArgumentException	serializedFilePath 是空字串，而 serializationVersion 則是 SyncFrameworkVersion1 或 WindowsSync 以外的值。
SyncIdFormatMismatchException	replicaId 的格式並非 idFormats 所指定的格式。
SyncInvalidOperationException	中繼資料存放區未開啟。
ExplicitTransactionRequiredException	交易無法用來序列化中繼資料。

備註

呼叫這個方法之前，必須符合兩個條件：

• 您必須開啟中繼資料存放區。請透過呼叫 OpenStore 或 CreateStore 開啟存放區。

• 使用中交易必須存在 SqlMetadataStore 物件上。請透過呼叫 BeginTransaction 啟動交易。

如果其中一項條件不符，呼叫這個方法就會導致例外狀況。

請參閱

參考

SqlSyncMetadataStoreSerializer 類別
SqlSyncMetadataStoreSerializer 成員
Microsoft.Synchronization.MetadataStorage 命名空間