IStatement.ExecuteBatch Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Invia un batch di comandi al database per l'esecuzione e, se tutti i comandi vengono eseguiti correttamente, restituisce una matrice di conteggi degli aggiornamenti.
[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[]
Restituisce
matrice di conteggi degli aggiornamenti contenente un elemento per ogni comando nel batch. Gli elementi della matrice vengono ordinati in base all'ordine in cui i comandi sono stati aggiunti al batch.
- Attributi
Eccezioni
se si verifica un errore durante l'accesso al database.
Commenti
Invia un batch di comandi al database per l'esecuzione e, se tutti i comandi vengono eseguiti correttamente, restituisce una matrice di conteggi degli aggiornamenti. Gli int
elementi della matrice restituiti vengono ordinati in modo che corrispondano ai comandi del batch, ordinati in base all'ordine in cui sono stati aggiunti al batch. Gli elementi nella matrice restituita dal metodo executeBatch
possono essere uno dei seguenti: OL<>LI>A numero maggiore o uguale a zero- <indica che il comando è stato elaborato correttamente ed è un conteggio degli aggiornamenti che fornisce il numero di righe nel database interessate dal valore SUCCESS_NO_INFO
LI>A dell'esecuzione <del comando - indica che il comando è stato elaborato correttamente, ma che il numero di righe interessate è sconosciuto
Se uno dei comandi di un aggiornamento batch non viene eseguito correttamente, questo metodo genera un'eccezione BatchUpdateException
e un driver JDBC potrebbe continuare o meno a elaborare i comandi rimanenti nel batch. Tuttavia, il comportamento del driver deve essere coerente con un particolare DBMS, continuando sempre a elaborare i comandi o non continuando mai a elaborare i comandi. Se il driver continua l'elaborazione dopo un errore, la matrice restituita dal metodo BatchUpdateException.getUpdateCounts
conterrà il numero di elementi presenti nel batch e almeno uno degli elementi sarà il seguente:
<Valore LI>: EXECUTE_FAILED
indica che il comando non è riuscito a essere eseguito correttamente e si verifica solo se un driver continua a elaborare i comandi dopo che un comando ha esito negativo </OL>
Le possibili implementazioni e i valori restituiti sono stati modificati in Java 2 SDK, edizione Standard versione 1.3 per supportare l'opzione di continuare a elaborare i comandi in un aggiornamento batch dopo che è stato generato un BatchUpdateException
obejct.
Aggiunta nella versione 1.2.
Documentazione java per java.sql.Statement.executeBatch()
.
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.