Método KnowledgeSyncProvider.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 possuem IDs maiores do que o limite inferior especificado, como parte de uma enumeração completa.

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

Sintaxe

'Declaração
Public MustOverride Function GetFullEnumerationChangeBatch ( _
    batchSize As UInteger, _
    lowerEnumerationBound As SyncId, _
    knowledgeForDataRetrieval As SyncKnowledge, _
    <OutAttribute> ByRef changeDataRetriever As Object _
) As FullEnumerationChangeBatch
'Uso
Dim instance As KnowledgeSyncProvider
Dim batchSize As UInteger
Dim lowerEnumerationBound As SyncId
Dim knowledgeForDataRetrieval As SyncKnowledge
Dim changeDataRetriever As Object
Dim returnValue As FullEnumerationChangeBatch

returnValue = instance.GetFullEnumerationChangeBatch(batchSize, lowerEnumerationBound, knowledgeForDataRetrieval, changeDataRetriever)

public abstract FullEnumerationChangeBatch GetFullEnumerationChangeBatch (
    uint batchSize,
    SyncId lowerEnumerationBound,
    SyncKnowledge knowledgeForDataRetrieval,
    out Object changeDataRetriever
)

public:
virtual FullEnumerationChangeBatch^ GetFullEnumerationChangeBatch (
    unsigned int batchSize, 
    SyncId^ lowerEnumerationBound, 
    SyncKnowledge^ knowledgeForDataRetrieval, 
    [OutAttribute] Object^% changeDataRetriever
) abstract

public abstract FullEnumerationChangeBatch GetFullEnumerationChangeBatch (
    UInt32 batchSize, 
    SyncId lowerEnumerationBound, 
    SyncKnowledge knowledgeForDataRetrieval, 
    /** @attribute OutAttribute() */ /** @ref */ Object changeDataRetriever
)

JScript does not support passing value-type arguments by reference.

Parâmetros

batchSize
O número de alterações a serem incluídas no lote de alterações.

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

knowledgeForDataRetrieval
Se uma alteração de item estiver contida neste objeto de conhecimento, os dados desse item já existirão na réplica de destino.

changeDataRetriever
Retorna um objeto que pode ser usado para recuperar dados de alteração. Pode ser um objeto IChangeDataRetriever ou um objeto específico ao provedor.

Valor de retorno

Um lote de alterações que contém metadados para os itens que possuem IDs maiores do que o limite inferior especificado, como parte de uma enumeração completa.

Comentários

Este método é chamado por Sync Framework durante a recuperação de conhecimento esquecido.

Este método enumera, em ordem classificada pela ID do item, as alterações com uma ID de item de lowerEnumerationBound ou maior. Isso permite ao Sync Framework determinar quais itens no provedor de destino foram excluídos, mas esquecidos pelo provedor de origem. Como opção, este método também pode adicionar alterações ao lote classificado por ID de item que tem ID de item menor do que lowerEnumerationBound e que não estão contidas no conhecimento de destino.

Observações para implementadores: Se não houver mais nenhuma alteração para enviar depois deste lote, IsLastBatch deve ser definido como true no lote de alterações retornado. Caso contrário, o Sync Framework chamará GetFullEnumerationChangeBatch novamente para recuperar outro lote de alterações. Para um provedor que envia dados de item juntamente com metadados de alteração de item, knowledgeForDataRetrieval 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 knowledgeForDataRetrieval.

Consulte também

Referência

Classe KnowledgeSyncProvider
Membros KnowledgeSyncProvider
Namespace Microsoft.Synchronization

Conceitos

Recuperando uma réplica desatualizada

Partilhar via