Compartir a través de

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

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

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

Parámetros

  • serializedFilePath
    Archivo que contiene los metadatos serializados para una réplica determinada.
  • expectedProviderCompatibilityVersion
    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 un valor es una referencia nula (Nothing en Visual Basic)., o bien se llama a los métodos de providerUpgradeCallback si providerUpgradeCallback no es un valor es una referencia nula (Nothing en Visual Basic).. Para obtener más información, vea Obtener acceso a los metadatos desde componentes con versiones diferentes y Actualizar la versión del almacén de metadatos.
  • providerUpgradeCallback
    Métodos de devolución de llamada a los que se llama cuando se debe actualizar el formato del almacén de metadatos porque la versión del proveedor de los metadatos serializados no es igual que la de expectedProviderCompatibilityVersion.

Valor devuelto

true cuando hay metadatos para deserializar; en caso contrario, false.

Excepciones

Tipo de excepción Condición

ArgumentNullException

Un parámetro requerido es un valor es una referencia nula (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 un valor es una referencia nula (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