Método CancelBatch (ADO)
Cancela una actualización por lotes pendiente.
Sintaxis
recordset.CancelBatchAffectRecords
Parámetros
AffectRecords
Opcional. Valor AffectEnum que indica cuántos registros afectarán al método CancelBatch.
Observaciones
Use el método CancelBatch para cancelar las actualizaciones pendientes en un recordset de en modo de actualización por lotes. Si el Recordset está en modo de actualización inmediata, llamar a CancelBatch sin adAffectCurrent genera un error.
Si está editando el registro actual o agrega 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 del conjunto de registros de.
El registro actual puede ser indeterminable después de una llamada de 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 recordset de después de la llamada 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 ha eliminado un registro), el proveedor devuelve advertencias al Errors colección, 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. Use la propiedad Filter (adFilterAffectedRecords) y la propiedad Status de para buscar registros con conflictos.
Se aplica a
Consulte también
Ejemplo de métodos UpdateBatch y CancelBatch de (VB)
Ejemplo de métodos UpdateBatch y CancelBatch (VC++)
del método Cancel (ADO) de
del método Cancel (RDS) de
método CancelUpdate (ADO)
método CancelUpdate (RDS)
método Clear (ADO) de
propiedad LockType (ADO)
del método UpdateBatch de