Método UpdateBatch (ADO)
Se aplica a: Access 2013, Office 2013
Escribe en el disco todas las actualizaciones por lotes que están pendientes.
Sintaxis
conjunto de registros. UpdateBatch 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 UpdateBatch. |
Comentarios
Use el método UpdateBatch cuando modifique un objeto Recordset en modo de actualización por lotes para transmitir todos los cambios realizados en el objeto Recordset a la base de datos subyacente.
Si el objeto Recordset admite la actualización por lotes, se pueden almacenar en la memoria caché local varios cambios realizados en uno o varios registros hasta que se llama al método UpdateBatch. Si está modificando el registro actual o agregando un nuevo registro mientras llama al método UpdateBatch, ADO llamará automáticamente al método Update para guardar todos los cambios pendientes en el registro actual antes de transmitir al proveedor los cambios por lotes. La actualización por lotes debe utilizarse únicamente con un cursor estático o un cursor dirigido por un conjunto de claves.
Nota:
[!NOTA] Si se especifica adAffectGroup como valor para este parámetro, se producirá un error cuando no haya registros visibles en el actual objeto Recordset (como un filtro sin registros coincidentes).
Si un intento de transmitir los cambios de algunos o todos los registros genera un error debido a un conflicto con los datos subyacentes (por ejemplo, otro usuario ya ha eliminado un registro), el proveedor devuelve advertencias a la colección Errors y se genera un error en tiempo de ejecución. Utilice la propiedad Filter (adFilterAffectedRecords) y la propiedad Status para localizar los registros con conflictos.
Para cancelar todas las actualizaciones por lotes que estén pendientes, utilice el método CancelBatch.
Si están establecidas las propiedades dinámicas Unique Table y Update Resync, y el objeto Recordset es el resultado de la ejecución de una operación JOIN en varias tablas, la ejecución del método UpdateBatch va implícitamente seguida del método Resync, según el valor de la propiedad Update Resync.
El orden en que se ejecutan las actualizaciones individuales de un lote en el origen de datos no es necesariamente el mismo orden en que se realizan en el objeto Recordset local. El orden de actualización depende del proveedor. Téngalo en cuenta cuando codifique actualizaciones relacionadas entre sí, como las restricciones de clave externa en una inserción o una actualización.