CancelUpdate-Methode (ADO)

Gilt für: Access 2013, Office 2013

Alle an der aktuellen oder neuen Zeile eines Recordset-Objekts oder der Fields-Auflistung eines Record-Objekts vorgenommenen Änderungen werden abgebrochen, bevor die Update-Methode aufgerufen wird.

Syntax

recordset. CancelUpdate

datensatz. Felder. CancelUpdate

Hinweise

Recordset

Verwenden Sie die CancelUpdate -Methode, um alle an der aktuellen Zeile vorgenommenen Änderungen abzubrechen oder eine neu hinzugefügte Zeile zu verwerfen. Sie können Änderungen an der aktuellen Zeile oder an einer neuen Zeile nach dem Aufrufen der Update -Methode nur abbrechen, wenn die Änderungen Teil einer Transaktion, für die Sie mit der RollbackTrans-Methode ein Rollback ausführen können, oder Teil einer Batchaktualisierung sind. Im Fall einer Batchaktualisierung können Sie die Update -Methode mit den Methoden CancelUpdate oder CancelBatch abbrechen.

Wenn Sie eine neue Zeile hinzufügen, wenn Sie die CancelUpdate -Methode aufrufen, wird die Zeile, die vor dem AddNew-Aufruf aktuell war, zur aktuellen Zeile.

Wenn Sie im Bearbeitungsmodus den aktuellen Datensatz verlassen möchten (z. B. mit Move, NextRecordset oder Close), können Sie mit CancelUpdate alle ausstehenden Änderungen abbrechen. Möglicherweise müssen Sie dies tun, wenn die Aktualisierung nicht erfolgreich für die Datenquelle bereitgestellt werden kann (z. B. bleibt bei einem Löschversuch, der aufgrund von Verletzungen der referenziellen Integrität fehlschlägt, das Recordset nach einem Aufruf von Delete im Bearbeitungsmodus).

Record

Die CancelUpdate-Methode bricht alle ausstehenden Einfügungen oder Löschungen von Field-Objekten ab und bricht ausstehende Aktualisierungen vorhandener Felder ab und stellt sie auf ihre ursprünglichen Werte wieder her. Die Status-Eigenschaft aller Felder in der Fields-Auflistung ist auf adFieldOK festgelegt.