Data.Win.ADODB.TCustomADODataSet.CancelBatch

Aller au parent : TCustomADODataSet

Delphi

procedure CancelBatch(AffectRecords: TAffectRecords = arAll);

C++

void __fastcall CancelBatch(TAffectRecords AffectRecords = (TAffectRecords)(0x2));

Propriétés

Type	Visibilité	Source	Unité	Parent
procedure function	public	Data.Win.ADODB.pas Data.Win.ADODB.hpp	Data.Win.ADODB	TCustomADODataSet

Description

Annule une mise à jour groupée en attente.

Appelez la méthode CancelBatch pour annuler toutes les mises à jour en attente dans un ensemble de données qui a été ouvert en mode mise à jour groupée. CancelBatch peut être appelée sans générer d'erreur en l'absence de mises à jour en attente, mais cela n'a aucun effet.

CancelBatch ne s'utilise pas avec les ensembles de données en mode mise à jour immédiate. L'appel de CancelBatch pour de tels ensembles de données sans la constante arCurrent déclenche une exception.

La valeur par défaut du paramètre AffectsRecords est arAll.

Le paramètre AffectRecords peut prendre l'une des valeurs TAffectRecords suivantes :

Option	Signification
arCurrent	Applique uniquement les modifications de la ligne en cours.
arFiltered	Applique uniquement les modifications des lignes vérifiant le filtre en cours.
arAll	Applique les modifications de toutes les lignes.
arAllChapters	Les modifications affectent tous les chapitres (il s'agit des chapitres ADO).

Remarque : : Pour utiliser les mises à groupées, la propriété CursorType du composant ensemble de données doit avoir la valeur ctKeyset (valeur par défaut) ou ctStatic et la propriété LockType doit être à ltBatchOptimistic.