Delete-Methode (ADO-Recordset)
Gilt für: Access 2013, Office 2013
Löscht den aktuellen Datensatz oder eine Gruppe von Datensätzen.
Syntax
recordset. Löschen von AffectRecords
Parameter
| Parameter | Beschreibung |
|---|---|
| AffectRecords | Ein AffectEnum-Wert, der bestimmt, wie viele Datensätze die Delete -Methode beeinflusst. Der Standardwert lautet adAffectCurrent. |
Hinweis
adAffectAll und adAffectAllChapters sind keine gültigen Argumente für Delete.
Hinweise
Mithilfe der Delete-Methode kann der aktuelle Datensatz oder eine Gruppe von Datensätzen in einem Recordset-Objekt zum Löschen markiert werden. Lässt das Recordset-Objekt das Löschen von Datensätzen nicht zu, tritt ein Fehler auf. Wenn Sie sich im Modus der unmittelbaren Aktualisierung befinden, werden die Löschvorgänge unmittelbar in der Datenbank angezeigt. Kann ein Datensatz nicht gelöscht werden (z. B. aufgrund von Verletzungen der Datenbankintegrität), verbleibt der Datensatz nach dem Aufrufen von Update im Bearbeitungsmodus. Folglich müssen Sie die Aktualisierung mithilfe von CancelUpdate abbrechen, bevor Sie den aktuellen Datensatz verlassen können (z. B. mithilfe von Close, Move oder NextRecordset).
Wenn Sie sich im Batchaktualisierungsmodus befinden, werden die Datensätze zum Löschen aus dem Cache markiert, und der eigentliche Löschvorgang wird ausgeführt, sobald Sie die UpdateBatch-Methode aufgerufen haben. (Verwenden Sie die Filter-Eigenschaft, um die gelöschten Datensätze anzuzeigen.)
Beim Abrufen von Feldwerten aus den gelöschten Datensätzen wird ein Fehler generiert. Nach dem Löschen des aktuellen Datensatzes bleibt der gelöschte Datensatz der aktuelle Datensatz, bis Sie zu einem anderen Datensatz wechseln. Sobald Sie einen gelöschten Datensatz verlassen, können Sie nicht mehr auf diesen Datensatz zugreifen.
Wenn Sie Löschvorgänge in eine Transaktion schachteln, können Sie gelöschte Datensätze mithilfe der RollbackTrans-Methode wiederherstellen. Wenn Sie sich im Batchaktualisierungsmodus befinden, können Sie mithilfe der CancelBatch-Methode einen ausstehenden Löschvorgang oder eine Gruppe von ausstehenden Löschvorgängen abbrechen.
Wenn beim Löschen von Datensätzen ein Fehler aufgrund eines Konflikts mit den zugrunde liegenden Daten erzeugt wird (z. B. wurde ein Datensatz bereits von einem anderen Benutzer gelöscht), gibt der Anbieter Warnungen an die Errors-Auflistung zurück, aber die Ausführung des Programms wird nicht unterbrochen. Ein Laufzeitfehler tritt nur auf, wenn für alle angeforderten Datensätze Konflikte vorhanden sind.
Ist die dynamische Eigenschaft Unique Table festgelegt und handelt es sich beim Recordset -Objekt um das Ergebnis der Ausführung eines JOIN-Vorgangs für mehrere Tabellen, löscht die Delete -Methode nur Zeilen aus der Tabelle, die in der Unique Table-Eigenschaft angegeben ist.