Método CancelBatch (ADO)

Se aplica a: Access 2013, Office 2013

Cancela una actualización por lotes que está pendiente.

Sintaxis

conjunto de registros. CancelBatch AffectRecords

Parámetros

Parámetro	Descripción
AffectRecords	Es opcional. Valor de AffectEnum que indica el número de registros afectados por el método CancelBatch.

Comentarios

Use el método CancelBatch para cancelar cualquier actualización pendiente en un objeto Recordset en modo de actualización por lotes. Si el objeto Recordset está en modo de actualización inmediata y se llama a CancelBatch sin adAffectCurrent, se generará un error.

Si está modificando el registro actual o agregando un registro nuevo cuando llama a CancelBatch, ADO llamará primero al método CancelUpdate para cancelar los cambios almacenados en caché. A continuación, se cancelarán todos los cambios pendientes en el objeto Recordset.

Es posible que el registro actual sea indeterminable después de una llamada a CancelBatch , especialmente si estaba en proceso de agregar un nuevo registro. Por este motivo, es prudente establecer la posición del registro actual en una ubicación conocida en el objeto Recordset después de la llamada a CancelBatch . Por ejemplo, llame al método MoveFirst .

Si un intento de cancelar las actualizaciones pendientes genera un error debido a un conflicto con los datos subyacentes (por ejemplo, otro usuario ha eliminado un registro), el proveedor devuelve advertencias a la colección Errors pero no detiene la ejecución del programa. Se produce un error en tiempo de ejecución sólo si hay conflictos en todos los registros solicitados. Utilice la propiedad Filter (adFilterAffectedRecords) y la propiedad Status para localizar los registros con conflictos.