Compartir a través de

DeserializeReplicaMetadata Método

  • Artículo

Deserializa el contenido de un archivo de metadatos canónico en un almacén de Metadata Storage Service. Opcionalmente, actualiza el formato del almacén de metadatos cuando cambia la versión del proveedor.

Espacio de nombres:  Microsoft.Synchronization.MetadataStorage
Ensamblado:  Microsoft.Synchronization.MetadataStorage (en Microsoft.Synchronization.MetadataStorage.dll)

Sintaxis

'Declaración
Public Overrides Function DeserializeReplicaMetadata ( _
    serializedFilePath As String, _
    expectedProviderCompatibilityVersion As UInteger, _
    providerUpgradeCallback As IProviderUpgradeCallback _
) As Boolean
'Uso
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

Parámetros

  • serializedFilePath
    Tipo: System. . :: . .String
    Archivo que contiene los metadatos serializados para una réplica determinada.
  • expectedProviderCompatibilityVersion
    Tipo: System. . :: . .UInt32
    Versión de compatibilidad de proveedor que se espera que esté incluida en el archivo de metadatos canónico. Si la versión esperada no coincide con la versión real, se produce un error de diseño en la deserialización si providerUpgradeCallback es una nullNothingnullptrunites una referencia NULL (Nothing en Visual Basic)., o bien se llama a los métodos de providerUpgradeCallback si providerUpgradeCallback no es una nullNothingnullptrunites una referencia NULL (Nothing en Visual Basic).. Para obtener más información, vea los temas sobre el acceso a los metadatos desde componentes con versiones diferentes y la actualización de Metadata Store Version .

Valor devuelto

Tipo: System. . :: . .Boolean
true cuando hay metadatos para deserializar; de lo contrario, false.

Excepciones

Excepción Condición
ArgumentNullException

Un parámetro requerido es una null Nothing nullptr unit es una referencia NULL (Nothing en Visual Basic). .
ArgumentException

serializedFilePath es una cadena vacía.
ExplicitTransactionRequiredException

No hay disponible una transacción en la que deserializar los metadatos.
MetadataStoreProviderVersionMismatchException

La versión de compatibilidad de proveedor especificada para expectedProviderCompatibilityVersion no coincide con la versión especificada en el archivo de metadatos canónico y providerUpgradeCallback es una null Nothing nullptr unit es una referencia NULL (Nothing en Visual Basic). .
SyncInvalidOperationException

El almacén de metadatos no está abierto.

Notas

Se deben cumplir tres condiciones antes de llamar a este método:

  • El almacén de metadatos debe estar abierto. Para abrir un almacén, llame a OpenStore o CreateStore.

  • La réplica para la que se deserializan los datos ya debe tener inicializado su almacén de metadatos. Para inicializar un almacén de metadatos, llame a InitializeReplicaMetadata.

  • Debe haber disponible una transacción activa en el objeto SqlMetadataStore. Para iniciar una transacción, llame a BeginTransaction.

Si se llama a este método cuando no se cumple alguna de estas condiciones, se produce una excepción.

Este método se puede utilizar como parte del procedimiento para actualizar el esquema de los metadatos cuando cambia la versión del proveedor. Para obtener más información, vea Actualizar la versión del almacén de metadatos.

Vea también

Referencia

SqlSyncMetadataStoreSerializer Clase

SqlSyncMetadataStoreSerializer Miembros

Microsoft.Synchronization.MetadataStorage Espacio de nombres