Поделиться через


IStatement.ExecuteBatch Метод

Определение

Отправляет пакет команд в базу данных для выполнения, а если все команды выполняются успешно, возвращает массив счетчиков обновлений.

[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[]

Возвращаемое значение

Int32[]

массив счетчиков обновлений, содержащих один элемент для каждой команды в пакете. Элементы массива упорядочены в соответствии с порядком добавления команд в пакет.

Атрибуты

Исключения

Если ошибка возникает при доступе к базе данных.

Комментарии

Отправляет пакет команд в базу данных для выполнения, а если все команды выполняются успешно, возвращает массив счетчиков обновлений. Элементы int возвращаемого массива упорядочены для соответствия командам в пакете, которые упорядочены в соответствии с порядком, в котором они были добавлены в пакет. Элементы массива, возвращаемого методомexecuteBatch, могут быть одним из следующих: <ЧИСЛО OL><LI>БОЛЬШЕ или равно нулю — указывает, что команда успешно обработана и является числом обновлений, предоставляющим количество строк в базе данных, затронутых значением SUCCESS_NO_INFO LI>выполнения <команды, указывает, что команда успешно обработана, но число затронутых строк неизвестно.

Если одна из команд в пакетном обновлении не выполняется должным образом, этот метод создает исключение BatchUpdateException, а драйвер JDBC может или не продолжать обрабатывать оставшиеся команды в пакете. Однако поведение драйвера должно быть согласовано с определенной СУБД, всегда продолжая обрабатывать команды или никогда не продолжая обрабатывать команды. Если драйвер продолжает обработку после сбоя, массив, возвращаемый методом BatchUpdateException.getUpdateCounts , будет содержать столько элементов, сколько команд в пакете, и по крайней мере один из элементов будет следующим:

<ЗНАЧЕНИЕ LI>. EXECUTE_FAILED Указывает, что команда не выполнена успешно и возникает только в том случае, если драйвер продолжает обрабатывать команды после сбоя <команды /OL>

Возможные реализации и возвращаемые значения были изменены в пакете SDK для Java 2, выпуск Standard версии 1.3, чтобы обеспечить возможность продолжения выполнения команд в пакетном обновлении после BatchUpdateException того, как был создан obejct.

Добавлено в версии 1.2.

Документация по Java для java.sql.Statement.executeBatch().

Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.

Применяется к