SerializeReplicaMetadata メソッド

指定されたレプリカの Metadata Storage Service ストアの内容を、正規の形式で同期先ファイルにシリアル化します。

名前空間:  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

abstract SerializeReplicaMetadata : 
        idFormats:SyncIdFormatGroup * 
        replicaId:SyncId * 
        serializedFilePath:string * 
        compatibilityLevel:CompatibilityLevel -> unit 
override SerializeReplicaMetadata : 
        idFormats:SyncIdFormatGroup * 
        replicaId:SyncId * 
        serializedFilePath:string * 
        compatibilityLevel:CompatibilityLevel -> unit 

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

パラメーター

• idFormats
  型 : Microsoft.Synchronization. . :: . .SyncIdFormatGroup
  プロバイダーの ID 形式スキーマ。

• replicaId
  型 : Microsoft.Synchronization. . :: . .SyncId
  メタデータをシリアル化する対象のレプリカの ID。

• serializedFilePath
  型 : System. . :: . .String
  メタデータをシリアル化する同期先ファイル。

• compatibilityLevel
  型 : Microsoft.Synchronization. . :: . .CompatibilityLevel
  シリアル化されたメタデータが Sync Framework のどのバージョンに対して有効かを指定する CompatibilityLevel 値。たとえば、ネイティブなナレッジのシリアル化形式が Sync Framework 2.x であっても、このパラメーターに指定された値が Sync Framework 1.0 の場合、ナレッジの値は 1.0 形式でシリアル化されます。1.0 形式ではシリアル化できないいずれかの 2.x 機能がナレッジ値に使用されている場合、シリアル化によって InvalidSerializationVersionException 例外がスローされます。

例外

例外	条件
ArgumentNullException	必須パラメーターが null Nothing nullptr unit NULL 参照 (Visual Basic では Nothing) です。
ArgumentException	serializedFilePath が空の文字列であるか、serializationVersion が SyncFrameworkVersion1 または WindowsSync 以外の値です。
SyncIdFormatMismatchException	replicaId の形式が idFormats で指定された形式ではありません。
SyncInvalidOperationException	メタデータ ストアが開いていません。
ExplicitTransactionRequiredException	メタデータをシリアル化するためのトランザクションを使用できません。

説明

このメソッドを呼び出す前に、次の 2 つの条件が満たされている必要があります。

• メタデータ ストアが開かれている必要があります。ストアを開くには、OpenStore または CreateStore を呼び出します。

• SqlMetadataStore オブジェクトでアクティブなトランザクションを使用できる必要があります。トランザクションを開始するには、BeginTransaction を呼び出します。

いずれかの条件が満たされていないときにこのメソッドを呼び出した場合、例外が発生します。

参照

参照

SqlSyncMetadataStoreSerializerクラス

SqlSyncMetadataStoreSerializer メンバー

Microsoft.Synchronization.MetadataStorage 名前空間