SqlSyncMetadataStoreSerializer.DeserializeReplicaMetadata-Methode

Deserialisiert den Inhalt einer kanonischen Metadatendatei in einen Metadaten-Speicherdienstspeicher. Aktualisiert optional das Metadaten-Speicherformat, wenn sich die Anbieterversion ändert.

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

Syntax

'Declaration
Public Overrides Function DeserializeReplicaMetadata ( _
    serializedFilePath As String, _
    expectedProviderCompatibilityVersion As UInteger, _
    providerUpgradeCallback As IProviderUpgradeCallback _
) As Boolean
'Usage
Dim instance As SqlSyncMetadataStoreSerializer
Dim serializedFilePath As String
Dim expectedProviderCompatibilityVersion As UInteger
Dim providerUpgradeCallback As IProviderUpgradeCallback
Dim returnValue As Boolean

returnValue = instance.DeserializeReplicaMetadata(serializedFilePath, expectedProviderCompatibilityVersion, providerUpgradeCallback)

public override bool DeserializeReplicaMetadata (
    string serializedFilePath,
    uint expectedProviderCompatibilityVersion,
    IProviderUpgradeCallback providerUpgradeCallback
)

public:
virtual bool DeserializeReplicaMetadata (
    String^ serializedFilePath, 
    unsigned int expectedProviderCompatibilityVersion, 
    IProviderUpgradeCallback^ providerUpgradeCallback
) override

public boolean DeserializeReplicaMetadata (
    String serializedFilePath, 
    UInt32 expectedProviderCompatibilityVersion, 
    IProviderUpgradeCallback providerUpgradeCallback
)

public override function DeserializeReplicaMetadata (
    serializedFilePath : String, 
    expectedProviderCompatibilityVersion : uint, 
    providerUpgradeCallback : IProviderUpgradeCallback
) : boolean

Parameter

• serializedFilePath
  Die Datei, die die serialisierten Metadaten für ein bestimmtes Replikat enthält.

• expectedProviderCompatibilityVersion
  Die Anbieterkompatibilitätsversion, die in der kanonischen Metadatendatei enthalten sein sollte. Wenn die erwartete Version nicht zur tatsächlichen Version passt, schlägt die Deserialisierung entweder beabsichtigt fehl, wenn providerUpgradeCallback eine NULL ist, oder providerUpgradeCallback-Methoden werden aufgerufen, wenn providerUpgradeCallback nicht NULL ist. Weitere Informationen finden Sie unter Zugreifen auf Metadaten von Komponenten anderer Versionen und Aktualisieren der Metadatenspeicherversion.

• providerUpgradeCallback
  Rückrufmethoden, die aufgerufen werden, wenn das Metadaten-Speicherformat aktualisiert werden muss, da die in den serialisierten Metadaten enthaltene Anbieterversion nicht die gleiche wie expectedProviderCompatibilityVersion ist.

Rückgabewert

true, wenn Metadaten zum Deserialisieren vorhanden sind, andernfalls false.

Ausnahmen

Hinweise

Drei 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.

• Das Replikat, für das Daten deserialisiert werden, muss seinen Metadatenspeicher bereits initialisiert haben. Um einen Metadatenspeicher zu initialisieren, rufen Sie InitializeReplicaMetadata auf.

• 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.

Diese Methode kann als Teil der Prozedur verwendet werden, um das Metadatenschema zu aktualisieren, wenn sich die Anbieterversion ändert. Weitere Informationen finden Sie unter Aktualisieren der Metadatenspeicherversion.

Siehe auch

Verweis

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