Data.Win.ADODB.TCustomADODataSet.DeleteRecords
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. |