Método UpdateBatch

Escribe todas las actualizaciones por lotes pendientes en el disco.

Sintaxis

  
recordset.UpdateBatch AffectRecords, PreserveStatus  

Parámetros

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

PreserveStatus
Opcional. Valor booleano que especifica si se deben confirmar los cambios locales, tal y 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.

Comentarios

Utilice el método UpdateBatch al modificar 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, puede almacenar en caché varios cambios en uno o varios registros localmente hasta que llame al método UpdateBatch. 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 el valor de este parámetro, se producirá un error cuando no haya registros visibles en el objeto Recordset actual (por ejemplo, un filtro para el que no coincida ningún registro).

Si se produce un error en el intento de transmitir los cambios de uno 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 Errors y se produce un error en tiempo de ejecución. Utilice la propiedad Filter (adFilterAffectedRecords) y la propiedad Status 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 Recordset es el resultado de ejecutar una operación JOIN en varias tablas, la ejecución del método UpdateBatch irá seguida implícitamente del método Resync, dependiendo 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 objeto Recordset 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

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 ++)
Método CancelBatch (ADO)
Clear (método) (ADO)
Propiedad LockType (ADO)
Update (método)