IStatement.ExecuteBatch Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Envia um lote de comandos para o banco de dados para execução e, se todos os comandos forem executados com êxito, retornará uma matriz de contagens de atualização.
[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[]Retornos
Uma matriz de contagens de atualização contendo um elemento para cada comando no lote. Os elementos da matriz são ordenados de acordo com a ordem em que os comandos foram adicionados ao lote.
- Atributos
Exceções
se ocorrer um erro ao acessar o banco de dados.
Comentários
Envia um lote de comandos para o banco de dados para execução e, se todos os comandos forem executados com êxito, retornará uma matriz de contagens de atualização. Os int elementos da matriz retornada são ordenados para corresponder aos comandos no lote, que são ordenados de acordo com a ordem em que foram adicionados ao lote. Os elementos na matriz retornados pelo método executeBatch podem ser um dos seguintes: <OL><LI>Um número maior ou igual a zero -- indica que o comando foi processado com êxito e é uma contagem de atualização que fornece o número de linhas no banco de dados que foram afetadas pela execução <do comando LI>Um valor de SUCCESS_NO_INFO -- indica que o comando foi processado com êxito, mas que o número de linhas afetadas é desconhecido
Se um dos comandos em uma atualização em lote não for executado corretamente, esse método lançará um BatchUpdateException, e um driver JDBC poderá ou não continuar a processar os comandos restantes no lote. No entanto, o comportamento do driver deve ser consistente com um DBMS específico, sempre continuando a processar comandos ou nunca continuando a processar comandos. Se o driver continuar processando após uma falha, a matriz retornada pelo método BatchUpdateException.getUpdateCounts conterá tantos elementos quantos forem os comandos no lote e pelo menos um dos elementos será o seguinte:
<>LI Um valor de EXECUTE_FAILED -- indica que o comando falhou ao ser executado com êxito e ocorre somente se um driver continuar a processar comandos depois que um comando falhar </OL>
As implementações possíveis e os valores de retorno foram modificados no SDK do Java 2, Standard Edition, versão 1.3 para acomodar a opção de continuar a processar comandos em uma atualização em lote após um BatchUpdateException obejct ter sido lançado.
Adicionado em 1.2.
Documentação Java para java.sql.Statement.executeBatch().
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.