CancelUpdate-Methode (ADO)
Bricht alle Änderungen, die an der aktuellen oder neuen Zeile eines Recordset- -Objekts oder der Fields -Auflistung eines Record -Objekts vorgenommen wurden, ab, bevor die Update -Methode aufgerufen wird.
Syntax
recordset.CancelUpdaterecord.Fields.CancelUpdate
Bemerkungen
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 einer neuen Zeile nicht abbrechen, nachdem Sie die Methode Update aufgerufen haben, es sei denn, die Änderungen sind Teil einer Transaktion, die Sie mit der RollbackTrans-Methode oder einem Teil einer Batchaktualisierung zurücksetzen können. Bei einer Batchaktualisierung 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 zur aktuellen Zeile, die vor dem Aufruf AddNew ausgeführt wurde.
Wenn Sie sich im Bearbeitungsmodus befinden und den aktuellen Datensatz deaktivieren möchten (z. B. mithilfe der Move, NextRecordset-oder Close-Methoden), können Sie CancelUpdate- verwenden, um ausstehende Änderungen abzubrechen. Möglicherweise müssen Sie dies tun, wenn das Update nicht erfolgreich in die Datenquelle gepostet werden kann. Ein versuchter Löschvorgang, der aufgrund von Verletzungen der referenziellen Integrität fehlschlägt, belässt das Recordset- Objekt nach einem Aufruf von Deleteim Bearbeitungsmodus.
Aufzeichnung
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 in ihren ursprünglichen Werten wieder her. Die eigenschaft Status aller Felder in der Fields collection ist auf adFieldOKfestgelegt.
Gilt für
Siehe auch
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