Data.Win.ADODB.TCustomADODataSet.CancelBatch

Übergeordnet: TCustomADODataSet

Delphi

procedure CancelBatch(AffectRecords: TAffectRecords = arAll);

C++

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

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
procedure function	public	Data.Win.ADODB.pas Data.Win.ADODB.hpp	Data.Win.ADODB	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.