Método CancelBatch (ADO)

Cancela una actualización por lotes pendiente.

Sintaxis

  
recordset.CancelBatchAffectRecords  

Parámetros

AffectRecords
Opcional. Valor de AffectEnum que indica cuántos registros afectará el método CancelBatch.

Comentarios

Use el método CancelBatch para cancelar las actualizaciones pendientes en un objeto Recordset en modo de actualización por lotes. Si el objeto Recordset está en modo de actualización inmediata, la llamada a CancelBatch sin adAffectCurrent genera un error.

Si está editando el registro actual o agregando un nuevo registro al llamar a CancelBatch, ADO llama primero al método CancelUpdate para cancelar los cambios almacenados en caché. Después de eso, se cancelan todos los cambios pendientes en el objeto Recordset.

El registro actual puede ser 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 se produce un error en el intento de cancelar las actualizaciones pendientes debido a un conflicto con los datos subyacentes (por ejemplo, si otro usuario ya ha eliminado un registro), el proveedor devuelve advertencias a la colección Errors, pero no detiene la ejecución del programa. Un error en tiempo de ejecución solo se produce si hay conflictos en todos los registros solicitados. Utilice la propiedad Filter (adFilterAffectedRecords) y la propiedad Status para buscar registros con conflictos.

Se aplica a

Objeto de conjunto de registros (ADO)

Consulte también

Ejemplo de los métodos UpdateBatch y CancelBatch (VB)
Ejemplo de los métodos UpdateBatch y CancelBatch (VC ++)
Cancel (método) (ADO)
Cancel (método) (RDS)
Método CancelUpdate (ADO)
Método CancelUpdate (RDS)
Clear (método) (ADO)
Propiedad LockType (ADO)
Método UpdateBatch