CancelBatch-Methode (ADO)

Gilt für: Access 2013, Office 2013

Eine ausstehende Batchaktualisierung wird abgebrochen.

Syntax

recordset. CancelBatch AffectRecords

Parameter

Parameter	Beschreibung
AffectRecords	Optional. Ein AffectEnum-Wert, durch den angegeben wird, auf wie viele Datensätze sich die CancelBatch-Methode auswirkt.

Hinweise

Verwenden Sie die CancelBatch -Methode, um alle ausstehenden Aktualisierungen in einem Recordset im Batchaktualisierungsmodus abzubrechen. Wenn sich das Recordset im Modus für sofortige Aktualisierungen befindet, wird durch Aufrufen von CancelBatch ohne adAffectCurrent ein Fehler generiert.

Wenn Sie den aktuellen Datensatz bearbeiten oder einen neuen Datensatz hinzufügen, wenn Sie CancelBatch aufrufen, wird von ADO zuerst die CancelUpdate-Methode aufgerufen, um alle zwischengespeicherten Änderungen abzubrechen. Danach werden alle ausstehenden Änderungen im Recordset abgebrochen.

Es ist möglich, dass nach einem CancelBatch-Aufruf der aktuelle Datensatz nicht ermittelt werden kann, insbesondere, wenn Sie dabei waren, einen neuen Datensatz hinzuzufügen. Aus diesem Grund ist es ratsam, nach dem CancelBatch-Aufruf die aktuelle Datensatzposition auf eine bekannte Stelle im Recordset festzulegen. Rufen Sie z. B. 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, hält die Programmausführung jedoch nicht an. Ein Laufzeitfehler tritt nur auf, wenn für alle angeforderten Datensätze Konflikte vorhanden sind. Verwenden Sie die Filter-Eigenschaft (adFilterAffectedRecords) und die Status-Eigenschaft, um nach Datensätzen mit Konflikten zu suchen.