CancelBatch-Methode (ADO)

  • Artikel

Bricht ein ausstehendes Batchupdate ab.

Syntax

  
recordset.CancelBatchAffectRecords

Parameter

AffectRecords
Optional. Ein AffectEnum-Wert, der angibt, wie viele Datensätze von der CancelBatch-Methode betroffen sein werden.

Bemerkungen

Verwenden Sie die CancelBatch-Methode, um ausstehende Updates in einem Recordset im Batchupdate-Modus abzubrechen. Wenn sich das Recordset im sofortigen Aktualisierungsmodus befindet, erzeugt der Aufruf von CancelBatch ohne adAffectCurrent einen Fehler.

Falls Sie den aktuellen Datensatz bearbeiten oder einen neuen Datensatz hinzufügen, wenn Sie CancelBatch aufrufen, ruft ADO zunächst die CancelUpdate-Methode auf, um alle zwischengespeicherten Änderungen rückgängig zu machen. Danach werden alle ausstehenden Änderungen im Recordset abgebrochen.

Nach dem Aufruf von CancelBatch kann der aktuelle Datensatz unbestimmbar sein, insbesondere wenn Sie gerade dabei waren, einen neuen Datensatz hinzuzufügen. Aus diesem Grund ist es ratsam, die aktuelle Datensatzposition nach dem CancelBatch-Aufruf an eine bekannte Stelle im Recordset zu setzen. Rufen Sie zum Beispiel die Methode MoveFirst auf.

Wenn der Versuch, die ausstehenden Aktualisierungen abzubrechen, aufgrund eines Konflikts mit den zugrundeliegenden Daten fehlschlägt (z.B. wenn ein Datensatz von einem anderen Benutzer gelöscht wurde), gibt der Anbieter Warnungen an die Sammlung Errors zurück, hält die Programmausführung aber nicht an. Ein Laufzeitfehler tritt nur auf, wenn es bei allen angeforderten Datensätzen Konflikte gibt. Verwenden Sie die Filter-Eigenschaft (adFilterAffectedRecords) und die Status-Eigenschaft, um Datensätze mit Konflikten zu suchen.

Gilt für

Recordset-Objekt (ADO)

Weitere Informationen

UpdateBatch- und CancelBatch-Methode – Beispiel (VB)
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