CancelUpdate-Methode (ADO)

Bricht alle Änderungen ab, die an der aktuellen oder neuen Zeile eines Recordset-Objekts oder der Fields-Auflistung eines Record-Objekts vorgenommen wurden, bevor die Update-Methode aufgerufen wurde.

Syntax

  
recordset.CancelUpdaterecord.Fields.CancelUpdate  

Bemerkungen

Recordset

Verwenden Sie die CancelUpdate-Methode, um alle Änderungen abzubrechen, die an der aktuellen Zeile vorgenommen wurden, oder um eine neu hinzugefügte Zeile zu verwerfen. Sie können Änderungen an der aktuellen Zeile oder eine neue Zeile nicht abbrechen, nachdem Sie die Update-Methode aufgerufen haben, es sei denn, die Änderungen sind Teil einer Transaktion, für die Sie ein Rollback mit der RollbackTrans-Methode ausführen können, oder sie sind Teil eines Batchupdates. Im Falle eines Batchupdates können Sie das Update mit der CancelUpdate- oder CancelBatch-Methode abbrechen.

Wenn Sie beim Aufrufen der CancelUpdate-Methode eine neue Zeile hinzufügen, wird die aktuelle Zeile zu der Zeile, die vor dem Aufruf von AddNew aktuell war.

Wenn Sie sich im Bearbeitungsmodus befinden und den aktuellen Datensatz wechseln möchten (z. B. mithilfe der Methoden Move, NextRecordset oder Close), können Sie CancelUpdate verwenden, um alle ausstehenden Änderungen abzubrechen. Dies müssen Sie möglicherweise tun, wenn das Update nicht erfolgreich in die Datenquelle gepostet werden kann. Beispielsweise belässt ein versuchter Löschvorgang, der aufgrund von Verletzungen der referentiellen Integrität fehlschlägt, das Recordset nach einem Aufruf von Delete im Bearbeitungsmodus.

Datensatz

Die CancelUpdate-Methode bricht alle ausstehenden Einfüge- oder Löschvorgänge von Field-Objekten ab, bricht ausstehende Aktualisierungen vorhandener Felder ab und stellt sie mit ihren ursprünglichen Werten wieder her. Die Status-Eigenschaft aller Felder in der Fields-Auflistung ist auf adFieldOK festgelegt.

Gilt für

Fields-Collection (ADO)

Recordset-Objekt (ADO)

Weitere Informationen

Update- und CancelUpdate-Methode – Beispiel (VB)
Update- und CancelUpdate-Methode – Beispiel (VC++)
AddNew-Methode (ADO)
Cancel-Methode (ADO)
Cancel-Methode (RDS)
CancelBatch-Methode (ADO)
CancelUpdate-Methode (RDS)
EditMode-Eigenschaft
Update-Methode