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

abstract DeserializeReplicaMetadata : 
        serializedFilePath:string * 
        expectedProviderCompatibilityVersion:uint32 * 
        providerUpgradeCallback:IProviderUpgradeCallback -> bool 
override DeserializeReplicaMetadata : 
        serializedFilePath:string * 
        expectedProviderCompatibilityVersion:uint32 * 
        providerUpgradeCallback:IProviderUpgradeCallback -> bool 

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

Parameter

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

• expectedProviderCompatibilityVersion
  Typ: System. . :: . .UInt32
  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 fb008b8f-a90b-4cbc-b718-7cb9c92a26ea Zugreifen auf Metadaten von Komponenten anderer Versionen und b3ff82fb-f946-4b7f-8a32-655535cf5e92 Aktualisieren der Metadatenspeicherversion.

• providerUpgradeCallback
  Typ: Microsoft.Synchronization.MetadataStorage. . :: . .IProviderUpgradeCallback
  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

Typ: System. . :: . .Boolean
true , wenn Metadaten zum Deserialisieren vorhanden sind, andernfalls false.

Ausnahmen

Ausnahme	Bedingung
ArgumentNullException	Ein erforderlicher Parameter ist NULL.
ArgumentException	serializedFilePath ist eine leere Zeichenfolge.
ExplicitTransactionRequiredException	Eine Transaktion, innerhalb derer Metadaten deserialisiert werden sollen, ist nicht verfügbar.
MetadataStoreProviderVersionMismatchException	Die Anbieterkompatibilitätsversion, die für expectedProviderCompatibilityVersion angegeben wurde, passt nicht zur in der kanonischen Metadatendatei angegebenen Version, und providerUpgradeCallback ist eine NULL.
SyncInvalidOperationException	Der Metadatenspeicher ist nicht offen.

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