IStatement.ExecuteBatch Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Envía un lote de comandos a la base de datos para su ejecución y, si todos los comandos se ejecutan correctamente, devuelve una matriz de recuentos de actualizaciones.
[Android.Runtime.Register("executeBatch", "()[I", "GetExecuteBatchHandler:Java.Sql.IStatementInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public int[]? ExecuteBatch ();[<Android.Runtime.Register("executeBatch", "()[I", "GetExecuteBatchHandler:Java.Sql.IStatementInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member ExecuteBatch : unit -> int[]Devoluciones
matriz de recuentos de actualizaciones que contienen un elemento para cada comando del lote. Los elementos de la matriz se ordenan según el orden en que se agregaron comandos al lote.
- Atributos
Excepciones
si se produce un error al acceder a la base de datos.
Comentarios
Envía un lote de comandos a la base de datos para su ejecución y, si todos los comandos se ejecutan correctamente, devuelve una matriz de recuentos de actualizaciones. Los int elementos de la matriz que se devuelven se ordenan para corresponder a los comandos del lote, que se ordenan según el orden en el que se agregaron al lote. Los elementos de la matriz devueltas por el método executeBatch pueden ser uno de los siguientes: <OL<>LI>Un número mayor o igual que cero: indica que el comando se procesó correctamente y es un recuento de actualizaciones que proporciona el número de filas de la base de datos afectadas por la ejecución del comando LI Un valor de LI>de ejecución <del SUCCESS_NO_INFO comando indica que el comando se procesó correctamente, pero que el número de filas afectadas es desconocido.
Si uno de los comandos de una actualización por lotes no se ejecuta correctamente, este método produce un BatchUpdateExceptiony un controlador JDBC puede o no seguir procesando los comandos restantes del lote. Sin embargo, el comportamiento del controlador debe ser coherente con un DBMS determinado, ya sea siempre continuar procesando comandos o nunca seguir procesando comandos. Si el controlador continúa procesando después de un error, la matriz devuelta por el método BatchUpdateException.getUpdateCounts contendrá tantos elementos como haya comandos en el lote y al menos uno de los elementos será el siguiente:
<LI>Un valor de : indica que el comando no se pudo ejecutar correctamente y se produce solo si un controlador continúa procesando comandos después de EXECUTE_FAILED que se produzca un error <en el comando /OL.>
Las posibles implementaciones y valores devueltos se han modificado en el SDK de Java 2, Standard Edition, versión 1.3 para dar cabida a la opción de continuar procesando comandos en una actualización por lotes después de que se haya producido un BatchUpdateException obejct.
Agregado en la versión 1.2.
Documentación de Java para java.sql.Statement.executeBatch().
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.