IStatement.ExecuteBatch Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Envoie un lot de commandes à la base de données pour l’exécution et, si toutes les commandes s’exécutent correctement, retourne un tableau de nombres de mises à jour.
[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[]Retours
tableau de nombres de mises à jour contenant un élément pour chaque commande du lot. Les éléments du tableau sont classés selon l’ordre dans lequel les commandes ont été ajoutées au lot.
- Attributs
Exceptions
si une erreur se produit lors de l’accès à la base de données.
Remarques
Envoie un lot de commandes à la base de données pour l’exécution et, si toutes les commandes s’exécutent correctement, retourne un tableau de nombres de mises à jour. Les int éléments du tableau retournés sont classés pour correspondre aux commandes du lot, qui sont classées selon l’ordre dans lequel ils ont été ajoutés au lot. Les éléments du tableau retournés par la méthode executeBatch peuvent être l’un des éléments suivants : <OL><LI>A nombre supérieur ou égal à zéro - indique que la commande a été traitée correctement et est un nombre de mises à jour indiquant le nombre de lignes dans la base de données affectées par la valeur LI>A de l’exécution <de SUCCESS_NO_INFO la commande -- indique que la commande a été traitée correctement, mais que le nombre de lignes affectées est inconnu
Si l’une des commandes d’une mise à jour par lot ne parvient pas à s’exécuter correctement, cette méthode lève un BatchUpdateExceptionpilote JDBC peut ou ne pas continuer à traiter les commandes restantes dans le lot. Toutefois, le comportement du pilote doit être cohérent avec un SGBD particulier, soit toujours continuer à traiter des commandes, soit ne jamais continuer à traiter des commandes. Si le pilote continue de traiter après une défaillance, le tableau retourné par la méthode BatchUpdateException.getUpdateCounts contient autant d’éléments qu’il existe des commandes dans le lot, et au moins l’un des éléments est le suivant :
<La valeur LI>A de EXECUTE_FAILED :- indique que la commande n’a pas réussi à s’exécuter correctement et se produit uniquement si un pilote continue à traiter les commandes après l’échec <d’une commande /OL>
Les implémentations possibles et les valeurs de retour ont été modifiées dans le Kit de développement logiciel (SDK) Java 2, Édition Standard, version 1.3 pour prendre en charge l’option de continuer à traiter les commandes dans une mise à jour par lots après qu’un BatchUpdateException obejct a été levée.
Ajouté dans la version 1.2.
Documentation Java pour java.sql.Statement.executeBatch().
Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.