Método KnowledgeSyncProvider.GetChangeBatch

Artigo
09/18/2009

Quando substituído em uma classe derivada, obtém um lote de alterações que contém metadados para os itens que não estão contidos no conhecimento especificado do provedor de destino.

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

Sintaxe

'Declaração
Public MustOverride Function GetChangeBatch ( _
    batchSize As UInteger, _
    destinationKnowledge As SyncKnowledge, _
    <OutAttribute> ByRef changeDataRetriever As Object _
) As ChangeBatch
'Uso
Dim instance As KnowledgeSyncProvider
Dim batchSize As UInteger
Dim destinationKnowledge As SyncKnowledge
Dim changeDataRetriever As Object
Dim returnValue As ChangeBatch

returnValue = instance.GetChangeBatch(batchSize, destinationKnowledge, changeDataRetriever)

public abstract ChangeBatch GetChangeBatch (
    uint batchSize,
    SyncKnowledge destinationKnowledge,
    out Object changeDataRetriever
)

public:
virtual ChangeBatch^ GetChangeBatch (
    unsigned int batchSize, 
    SyncKnowledge^ destinationKnowledge, 
    [OutAttribute] Object^% changeDataRetriever
) abstract

public abstract ChangeBatch GetChangeBatch (
    UInt32 batchSize, 
    SyncKnowledge destinationKnowledge, 
    /** @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.

destinationKnowledge
O conhecimento do provedor de destino. Esse conhecimento deve ser mapeado chamando MapRemoteKnowledgeToLocal no conhecimento de origem para que possa ser usado para a enumeração de alterações.

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 não estão contidos no conhecimento especificado do provedor de destino. Não pode ser um referência nula (Nothing no Visual Basic).

Comentários

A mesma alteração não aparecerá em vários lotes.

Se restarem menos alterações que o número especificado pelo batchSize, um lote menor será retornado.

Se esse método for chamado quando não restar nenhuma alteração, InvalidOperationException será lançada.

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, Estrutura de sincronização chamará GetChangeBatch novamente para recuperar outro lote de alterações.

Consulte também

Referência

Classe KnowledgeSyncProvider
Membros KnowledgeSyncProvider
Namespace Microsoft.Synchronization

Compartilhar via