UpdateBatch (método)
Escribe todas las actualizaciones por lotes pendientes en el disco.
Sintaxis
recordset.UpdateBatch AffectRecords, PreserveStatus
Parámetros
AffectRecords
Opcional. Valor de AffectEnum que indica cuántos registros afectarán al método UpdateBatch de.
PreserveStatus
Opcional. Valor de booleano que especifica si se deben confirmar los cambios locales, como se indica en la propiedad Status . Si este valor se establece en True, la propiedad Status de cada registro permanece sin cambios una vez completada la actualización.
Observaciones
Use el método UpdateBatch al modificar un objeto Recordset de en modo de actualización por lotes para transmitir todos los cambios realizados en un objeto Recordset a la base de datos subyacente.
Si el objeto Recordset admite la actualización por lotes, puede almacenar en caché varios cambios en uno o varios registros localmente hasta que llame al método updateBatch de. Si está editando el registro actual o agregando un nuevo registro al llamar al método UpdateBatch, ADO llamará automáticamente al método Update para guardar los cambios pendientes en el registro actual antes de transmitir los cambios por lotes al proveedor. Debe usar la actualización por lotes solo con un conjunto de claves o un cursor estático.
Nota
Si se especifica adAffectGroup como valor de este parámetro, se producirá un error cuando no haya registros visibles en el recordset de actual (por ejemplo, un filtro para el que no coinciden registros).
Si se produce un error en el intento de transmitir cambios para cualquiera o todos los registros 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 Errores y se produce un error en tiempo de ejecución. Use la propiedad Filter (adFilterAffectedRecords) y la propiedad Status de para buscar registros con conflictos.
Para cancelar todas las actualizaciones por lotes pendientes, use el método CancelBatch.
Si se establecen las propiedades dinámicas Unique Table y Update Resync, y el recordset es el resultado de ejecutar una operación JOIN en varias tablas, la ejecución del método UpdateBatch sigue implícitamente el método Resync, en función de la configuración de la propiedad Update Resync.
El orden en el que se realizan las actualizaciones individuales de un lote en el origen de datos no es necesariamente el mismo que el orden en el que se realizaron en el conjunto de registros local . El orden de actualización depende del proveedor. Tenga esto en cuenta al codificar actualizaciones relacionadas entre sí, como restricciones de clave externa en una inserción o actualización.
Se aplica a
Consulte también
Ejemplo de métodos UpdateBatch y CancelBatch de (VB)
Ejemplo de métodos UpdateBatch y CancelBatch (VC++)
método CancelBatch (ADO)
método Clear (ADO) de
propiedad LockType (ADO)
del método Update de