Méthode KnowledgeSyncProvider.GetFullEnumerationChangeBatch
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
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.
Paramètres
- batchSize
Nombre de modifications à inclure dans le lot de modifications.
- lowerEnumerationBound
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
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
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
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 de déterminer quels éléments sur le fournisseur de destination ont été supprimés mais oubliés par le fournisseur de source. Cette méthode peut éventuellement aussi ajouter des modifications au lot, trié 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 encore 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.
Voir aussi
Référence
Classe KnowledgeSyncProvider
Membres KnowledgeSyncProvider
Espace de noms Microsoft.Synchronization