SqlSyncMetadataStoreSerializer.SerializeReplicaMetadata-Methode

Serialisiert den Inhalt eines Metadaten-Speicherdienstspeichers für das angegebene Replikat in eine Zieldatei in einem kanonischen Format.

Namespace: Microsoft.Synchronization.MetadataStorage
Assembly: Microsoft.Synchronization.MetadataStorage (in microsoft.synchronization.metadatastorage.dll)

Syntax

'Declaration
Public Overrides Sub SerializeReplicaMetadata ( _
    idFormats As SyncIdFormatGroup, _
    replicaId As SyncId, _
    serializedFilePath As String, _
    compatibilityLevel As CompatibilityLevel _
)
'Usage
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
)

Parameter

• idFormats
  Das ID-Formatschema des Anbieters.

• replicaId
  Die ID des Replikats, für das Metadaten serialisiert werden sollen.

• serializedFilePath
  Die Zieldatei, in die Metadaten serialisiert werden.

• compatibilityLevel
  Ein CompatibilityLevel-Wert, der angibt, für welche Version von Sync Framework die serialisierten Metadaten gültig sind. Wenn zum Beispiel das systemeigene Wissensserialisierungsformat Sync Framework 2.0 ist, der angegebene Wert für diesen Parameter jedoch Sync Framework 1.0 ist, werden Wissenswerte im 1.0-Format serialisiert. Wenn Wissenswerte eine beliebige 2.0-Funktion verwenden, die nicht im 1.0-Format serialisiert werden kann, löst die Serialisierung eine InvalidSerializationVersionException-Ausnahme aus.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentNullException	Ein erforderlicher Parameter ist NULL.
ArgumentException	serializedFilePath ist eine leere Zeichenfolge; serializationVersion ist ein anderer Wert als SyncFrameworkVersion1 oder WindowsSync.
SyncIdFormatMismatchException	Das Format von replicaId ist nicht das von idFormats angegebene Format.
SyncInvalidOperationException	Der Metadatenspeicher ist nicht offen.
ExplicitTransactionRequiredException	Eine Transaktion, innerhalb derer Metadaten serialisiert werden sollen, ist nicht verfügbar.

Hinweise

Zwei Bedingungen müssen erfüllt werden, bevor diese Methode aufgerufen wird:

• Der Metadatenspeicher muss geöffnet sein. Öffnen Sie einen Speicher, indem Sie OpenStore oder CreateStore aufrufen.

• Eine aktive Transaktion muss auf dem SqlMetadataStore-Objekt verfügbar sein. Starten Sie eine Transaktion, indem Sie BeginTransaction aufrufen.

Das Aufrufen dieser Methode führt zu einer Ausnahme, wenn irgendeine dieser Bedingungen nicht erfüllt wird.

Siehe auch

Verweis

SqlSyncMetadataStoreSerializer-Klasse
SqlSyncMetadataStoreSerializer-Member
Microsoft.Synchronization.MetadataStorage-Namespace