CancelBatch-Methode (ADO)
Bricht eine ausstehende Batchaktualisierung ab.
Syntax
recordset.CancelBatchAffectRecords
Parameter
AffectRecords-
Wahlfrei. Ein AffectEnum Wert, der angibt, wie viele Datensätze die CancelBatch-Methode beeinflussen.
Bemerkungen
Verwenden Sie die CancelBatch Methode, um ausstehende Updates in einem Recordset- im Batchaktualisierungsmodus abzubrechen. Wenn sich das Recordset- im sofortigen Updatemodus befindet, generiert das Aufrufen CancelBatch ohne adAffectCurrent einen Fehler.
Wenn Sie den aktuellen Datensatz bearbeiten oder beim Aufrufen CancelBatch-einen neuen Datensatz hinzufügen, ruft ADO zuerst die CancelUpdate-Methode auf, um zwischengespeicherte Änderungen abzubrechen. Danach werden alle ausstehenden Änderungen im Recordset- abgebrochen.
Der aktuelle Datensatz kann nach einem CancelBatch Aufrufs unbestimmt sein, insbesondere, wenn Sie gerade einen neuen Datensatz hinzugefügt haben. Aus diesem Grund ist es umsichtig, die aktuelle Datensatzposition auf eine bekannte Position im Recordset nach dem aufruf CancelBatch festzulegen. Rufen Sie beispielsweise die MoveFirst-Methode auf.
Wenn der Versuch, die ausstehenden Updates abzubrechen, aufgrund eines Konflikts mit den zugrunde liegenden Daten fehlschlägt (z. B. wenn ein Datensatz von einem anderen Benutzer gelöscht wurde), gibt der Anbieter Warnungen an die Errors Auflistung zurück, aber die Programmausführung wird nicht angehalten. Ein Laufzeitfehler tritt nur auf, wenn konflikte in allen angeforderten Datensätzen vorhanden sind. Verwenden Sie die eigenschaft Filter (adFilterAffectedRecords) und die eigenschaft Status, um Datensätze mit Konflikten zu suchen.
Gilt für
Siehe auch
UpdateBatch- und CancelBatch-Methode (Vb-Beispiel)
UpdateBatch- und CancelBatch-Methode (Beispiel) (VC++)
Cancel-Methode (ADO)
Cancel-Methode (RDS)
CancelUpdate-Methode (ADO)
CancelUpdate-Methode (RDS)
Clear-Methode (ADO)
LockType-Eigenschaft (ADO)
UpdateBatch-Methode