GetFullEnumerationChangeBatch méthode

Article
08/18/2010

En cas de substitution dans une classe dérivée, obtient un lot de modifications qui contient les métadonnées d'élément pour les éléments dont les ID sont supérieurs à la limite inférieure spécifiée, dans le cadre d'une énumération complète.

Espace de noms : Microsoft.Synchronization
Assembly : Microsoft.Synchronization (dans Microsoft.Synchronization.dll)

Syntaxe

'Déclaration
Public MustOverride Function GetFullEnumerationChangeBatch ( _
    batchSize As UInteger, _
    lowerEnumerationBound As SyncId, _
    knowledgeForDataRetrieval As SyncKnowledge, _
    <OutAttribute> ByRef changeDataRetriever As Object _
) As FullEnumerationChangeBatch
'Utilisation
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

abstract GetFullEnumerationChangeBatch : 
        batchSize:uint32 * 
        lowerEnumerationBound:SyncId * 
        knowledgeForDataRetrieval:SyncKnowledge * 
        changeDataRetriever:Object byref -> FullEnumerationChangeBatch

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

Paramètres

batchSize
Type : System. . :: . .UInt32
Nombre de modifications à inclure dans le lot de modifications.

lowerEnumerationBound
Type : Microsoft.Synchronization. . :: . .SyncId
Limite inférieure pour les ID d'élément. Cette méthode retourne les modifications dont les ID sont supérieurs ou égaux à cette valeur d'ID.

knowledgeForDataRetrieval
Type : Microsoft.Synchronization. . :: . .SyncKnowledge
Si une modification d'élément est contenue dans cet objet de connaissance, les données de cet élément existent déjà sur le réplica de destination.

changeDataRetriever
Type : System. . :: . .Object%
Retourne un objet qui peut être utilisé pour récupérer des données de modification. Il peut s'agir d'un objet IChangeDataRetriever ou d'un objet spécifique au fournisseur.

Valeur de retour

Type : Microsoft.Synchronization. . :: . .FullEnumerationChangeBatch
Lot de modifications qui contient les métadonnées d'élément pour les éléments dont les ID sont supérieurs à la limite inférieure spécifiée, dans le cadre d'une énumération complète.

Notes

Cette méthode est appelée par Sync Framework pendant la récupération d'une connaissance oubliée.

Cette méthode énumère, en ordre trié par ID d'élément, les modifications ayant un ID d'élément supérieur ou égal à lowerEnumerationBound. Cela permet à Sync Framework d’identifier les éléments sur le fournisseur de destination qui ont été supprimés, mais oubliés par le fournisseur de source. Cette méthode peut éventuellement aussi ajouter des modifications au lot, triées par ID d'élément, dont les ID d'élément sont inférieurs à lowerEnumerationBound et qui ne sont pas contenues dans la connaissance de destination.

Remarques à l'attention des implémenteurs

S'il n'y a plus de modifications à envoyer après ce lot, vous devez affecter à la propriété IsLastBatch la valeur True sur le lot de modifications retourné. Sinon, Sync Framework appelle de nouveau la méthode GetFullEnumerationChangeBatch pour récupérer un autre lot de modifications.

Pour un fournisseur qui envoie des données d'élément avec des métadonnées de modification d'élément, knowledgeForDataRetrieval peut être utilisé pour déterminer s'il est nécessaire ou non d'envoyer des données d'élément. Il n'est pas nécessaire d'envoyer les données d'élément lorsque la modification d'élément est contenue dans knowledgeForDataRetrieval.