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クラス