Método ReplicaMetadata.GetFullEnumerationChangeBatch

Artigo
10/17/2009

Quando substituído em uma classe derivada, obtém um lote de alterações que contém metadados para os itens que têm IDs iguais ou maiores que o limite inferior especificado como parte de uma enumeração completa.

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

Sintaxe

'Declaração
Public MustOverride Function GetFullEnumerationChangeBatch ( _
    batchSize As UInteger, _
    lowerEnumerationBound As SyncId, _
    destinationKnowledge As SyncKnowledge _
) As FullEnumerationChangeBatch
'Uso
Dim instance As ReplicaMetadata
Dim batchSize As UInteger
Dim lowerEnumerationBound As SyncId
Dim destinationKnowledge As SyncKnowledge
Dim returnValue As FullEnumerationChangeBatch

returnValue = instance.GetFullEnumerationChangeBatch(batchSize, lowerEnumerationBound, destinationKnowledge)

public abstract FullEnumerationChangeBatch GetFullEnumerationChangeBatch (
    uint batchSize,
    SyncId lowerEnumerationBound,
    SyncKnowledge destinationKnowledge
)

public:
virtual FullEnumerationChangeBatch^ GetFullEnumerationChangeBatch (
    unsigned int batchSize, 
    SyncId^ lowerEnumerationBound, 
    SyncKnowledge^ destinationKnowledge
) abstract

public abstract FullEnumerationChangeBatch GetFullEnumerationChangeBatch (
    UInt32 batchSize, 
    SyncId lowerEnumerationBound, 
    SyncKnowledge destinationKnowledge
)

public abstract function GetFullEnumerationChangeBatch (
    batchSize : uint, 
    lowerEnumerationBound : SyncId, 
    destinationKnowledge : SyncKnowledge
) : FullEnumerationChangeBatch

Parâmetros

batchSize
O tamanho do lote de alterações a ser retornado.

lowerEnumerationBound
O limite inferior das IDs de itens. Este método deve retornar alterações que têm IDs maiores que ou iguais a este valor de ID.

destinationKnowledge
O conhecimento do provedor de destino.

Valor de retorno

Um lote de alterações que contém metadados de itens com IDs iguais ou maiores que o limite inferior especificado.

Exceções

Tipo de exceção	Condição
ObjectDisposedException	O objeto foi descartado ou não foi inicializado corretamente.
ArgumentOutOfRangeException	batchSize é 0.
ArgumentNullException	lowerEnumerationBound é um referência nula (Nothing no Visual Basic) ou destinationKnowledge é um referência nula (Nothing no Visual Basic).

Comentários

Este método ajuda um provedor de sincronização a implementar seu método GetFullEnumerationChangeBatch. Este método é chamado durante a recuperação de conhecimento esquecido.

Antes de os provedores chamarem este método, eles devem garantir que as versões no repositório de metadados reflitam todas as alterações locais, inclusive exclusões. Isso pode ser feito por uma passagem de manutenção de metadados explícita para enumerar itens e atualizar os metadados.

A implementação desta classe, que está disponível através de SqlMetadataStore, adiciona as alterações ao lote de alterações na ordem da ID global.

A implementação desta classe, que está disponível através de SqlMetadataStore, também retorna todos os itens que têm IDs menores que lowerEnumerationBound e que não estão contidos no destinationKnowledge.

A implementação desta classe, que está disponível através de SqlMetadataStore, define IsLastBatch como true no lote de alterações retornado quando não há mais nenhuma alteração a ser enviada.

Observações para implementadores: Este método deve enumerar, na ordem classificada pela ID do item, alterações que têm uma ID de item lowerEnumerationBound ou maior. Isso permite ao Sync Framework determinar quais itens no provedor de destino foram excluídos, mas esquecidos pelo provedor de origem. Se não houver mais nenhuma alteração a ser enviada depois deste lote, IsLastBatch deverá ser definido como true no lote de alterações retornado ou o Sync Framework chamará GetChangeBatch novamente para recuperar outro lote de alterações. Para um provedor que envia dados de item juntamente com metadados de alteração de item, destinationKnowledge pode ser usado para determinar se é necessário enviar dados de item. Os dados de item não precisam ser enviados quando a alteração do item está contida no destinationKnowledge.

Consulte também

Referência

Classe ReplicaMetadata
Membros ReplicaMetadata
Namespace Microsoft.Synchronization.MetadataStorage

Compartilhar via