ADODB.TCustomADODataSet.CancelBatch

Delphi-Informationen

von ADODB.pas

	procedure CancelBatch(AffectRecords: TAffectRecords = arAll);

Unit: ADODB

Typ: Methode

Sichtbarkeit: public

Member von: TCustomADODataSet

C++-Informationen

von ADODB.hpp

	void __fastcall CancelBatch(Adodb::TAffectRecords AffectRecords);

Unit: ADODB

Typ: Methode

Sichtbarkeit: public

Member von: TCustomADODataSet

Beschreibung

Bricht eine anstehende Batch-Aktualisierung ab.

Mit CancelBatch können Sie die anstehenden Aktualisierungen einer im Batch-Modus geöffneten Datenmenge abbrechen. Die Methode CancelBatch kann auch aufgerufen werden, wenn keine Aktualisierungen anstehen. Sie führt dann aber keine Operation durch.

CancelBatch darf nicht für Datenmengen verwendet werden, die im Direktmodus geöffnet wurden. Wenn Sie die Methode bei solchen Datenmengen ohne die Konstante arCurrent aufrufen, wird eine Exception ausgelöst.

Der Standardwert für AffectRecords ist arAll.

Der Parameter AffectRecords kann einen der folgenden TAffectRecords-Werte annehmen:

Option	Bedeutung
arCurrent	Es werden nur die Aktualisierungen des aktuellen Datensatzes eingetragen.
arFiltered	Es werden nur die Aktualisierungen der Datensätze eingetragen, die dem aktuellen Filter entsprechen.
arAll	Die Aktualisierungen aller Datensätze werden eingetragen.
arAllChapters	Die Aktualisierungen aller Chapter (ADO-Chapter) werden eingetragen.

Anmerkung: : Batch-Aktualisierungen sind nur möglich, wenn die Eigenschaft CursorType der Datenmenge den Wert ctKeySet (Standard) oder ctStatic und die Eigenschaft LockType den Wert ltBatchOptimistic hat.