Data.Win.ADODB.TCustomADODataSet.DeleteRecords

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure DeleteRecords(AffectRecords: TAffectRecords = arAll);

C++

void __fastcall DeleteRecords(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

Entfernt einen oder mehrere Datensätze aus der Datenmenge.

Mit DeleteRecords können Sie einen oder mehrere Datensätze aus dem Recordset-Objekt entfernen, das der ADO-Datenmenge zugrunde liegt.

Wenn das Recordset-Objekt keine Löschoperationen unterstützt, wird eine Exception ausgelöst. Prüfen Sie also zuvor mit der Methode Supports, ob Datensätze gelöscht werden können.

Wenn die Datenmenge für eine Batch-Aktualisierung geöffnet wurde, werden die Datensätze nur mit einer Löschmarkierung versehen. Die Änderungen können dann mit UpdateBatch eingetragen werden. Befindet sich die Datenmenge nicht im Batch-Modus, werden die Datensätze sofort gelöscht.

Der Parameter AffectRecords (eine Konstante des Typs TAffectRecords) bestimmt, welche Datensätze gelöscht werden. Beim Standardwert arAll bezieht sich die Operation auf alle Datensätze.



Option Beschreibung

arCurrent

Es wird nur der aktuelle Datensatz gelöscht.

arFiltered

Es werden nur die Datensätze gelöscht, die dem aktuellen Filter entsprechen.

arAll

Alle Datensätze werden gelöscht.

arAllChapters

Die Datensätze aller Chapter (ADO-Chapter) werden gelöscht.



Siehe auch