Delete-Methode (ADO-Recordset)
Löscht den aktuellen Datensatz oder eine Gruppe von Datensätzen.
Syntax
recordset.Delete AffectRecords
Parameter
AffectRecords-
Ein AffectEnum Wert, der bestimmt, wie viele Datensätze die Delete-Methode beeinflussen. Der Standardwert ist adAffectCurrent.
Anmerkung
adAffectAll und adAffectAllChapters sind keine gültigen Argumente zum Delete.
Bemerkungen
Mithilfe der Delete-Methode wird der aktuelle Datensatz oder eine Gruppe von Datensätzen in einem Recordset-Objekt zum Löschen markiert. Wenn das Recordset-Objekt das Löschen von Datensätzen nicht zulässt, tritt ein Fehler auf. Wenn Sie sich im sofortigen Aktualisierungsmodus befinden, treten Löschvorgänge sofort in der Datenbank auf. Wenn ein Datensatz nicht erfolgreich gelöscht werden kann (z. B. aufgrund von Verletzungen der Datenbankintegrität), verbleibt der Datensatz nach dem Aufruf von Updateim Bearbeitungsmodus. Dies bedeutet, dass Sie das Update mit CancelUpdate- abbrechen müssen, bevor Sie den aktuellen Datensatz verschieben (z. B. mit Close, Moveoder NextRecordset).
Wenn Sie sich im Batchaktualisierungsmodus befinden, werden die Datensätze für das Löschen aus dem Cache markiert, und der tatsächliche Löschvorgang erfolgt, wenn Sie die UpdateBatch--Methode aufrufen. Verwenden Sie die Filter--Eigenschaft, um die gelöschten Datensätze anzuzeigen.
Durch das Abrufen von Feldwerten aus dem gelöschten Datensatz wird ein Fehler generiert. Nach dem Löschen des aktuellen Datensatzes bleibt der gelöschte Datensatz aktuell, bis Sie zu einem anderen Datensatz wechseln. Nachdem Sie den gelöschten Datensatz entfernt haben, kann er nicht mehr darauf zugreifen.
Wenn Sie Löschvorgänge in einer Transaktion verschachteln, können Sie gelöschte Datensätze mit der RollbackTrans--Methode wiederherstellen. Wenn Sie sich im Batchaktualisierungsmodus befinden, können Sie einen ausstehenden Löschvorgang oder eine Gruppe ausstehender Löschungen mit der CancelBatch--Methode abbrechen.
Wenn der Versuch, Datensätze zu löschen, aufgrund eines Konflikts mit den zugrunde liegenden Daten fehlschlägt (z. B. wurde ein Datensatz bereits von einem anderen Benutzer gelöscht), gibt der Anbieter Warnungen an die Errors Collection zurück, aber die Programmausführung wird nicht angehalten. Ein Laufzeitfehler tritt nur auf, wenn konflikte in allen angeforderten Datensätzen vorhanden sind.
Wenn die Eindeutige Tabelle dynamische Eigenschaft festgelegt ist und das Recordset- das Ergebnis der Ausführung eines JOIN-Vorgangs für mehrere Tabellen ist, löscht die Delete-Methode nur Zeilen aus der Tabelle, die in der Unique Table-Eigenschaft benannt ist.
Gilt für
Siehe auch
Delete-Methode (VB-Beispiel)
Delete-Methode (VBScript-Beispiel)
Delete-Methode (VC++-Beispiel)
Delete-Methode (ADO Fields-Auflistung)
Delete-Methode (ADO Parameters-Auflistung)
DeleteRecord-Methode (ADO)