Método SqlSyncMetadataStoreSerializer.SerializeReplicaMetadata

Artigo
10/17/2009

Serializa, para a réplica especificada, o conteúdo de um repositório do serviço de armazenamento de metadados para um arquivo de destino em um formato canônico.

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

Sintaxe

'Declaração
Public Overrides Sub SerializeReplicaMetadata ( _
    idFormats As SyncIdFormatGroup, _
    replicaId As SyncId, _
    serializedFilePath As String, _
    compatibilityLevel As CompatibilityLevel _
)
'Uso
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
)

Parâmetros

idFormats
O esquema do formato da ID do provedor.

replicaId
A ID da réplica para a qual os metadados devem ser serializados.

serializedFilePath
O arquivo de destino para o qual os metadados são serializados.

compatibilityLevel
Um valor CompatibilityLevel que especifica para qual versão do Sync Framework os metadados serializados são válidos. Por exemplo, se o formato de serialização de conhecimento nativo for Sync Framework 2.0, mas o valor fornecido para esse parâmetro for Sync Framework 1.0, os valores de conhecimento serão serializados no formato 1.0. Se os valores de conhecimento usarem qualquer recurso do formato 2.0 que não possa ser serializado no formato 1.0, a serialização lançará uma exceção InvalidSerializationVersionException.

Exceções

Tipo de exceção	Condição
ArgumentNullException	Um parâmetro obrigatório é um referência nula (Nothing no Visual Basic).
ArgumentException	serializedFilePath é uma cadeia de caracteres vazia; serializationVersion é um valor diferente de SyncFrameworkVersion1 ou WindowsSync.
SyncIdFormatMismatchException	O formato de replicaId não é o especificado por idFormats.
SyncInvalidOperationException	O repositório de metadados não está aberto.
ExplicitTransactionRequiredException	Não há uma transação disponível na qual serializar os metadados.

Comentários

Duas condições devem ser atendidas antes de esse método ser chamado:

O repositório de metadados deve estar aberto. Abra um repositório chamando OpenStore ou CreateStore.
Uma transação ativa deve estar disponível no objeto SqlMetadataStore. Inicie uma transação chamando BeginTransaction.

Chamar esse método quando uma dessas condições não for atendida causará uma exceção.

Consulte também

Referência

Classe SqlSyncMetadataStoreSerializer
Membros SqlSyncMetadataStoreSerializer
Namespace Microsoft.Synchronization.MetadataStorage

Partilhar via