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[]
Возвращаемое значение
массив счетчиков обновлений, содержащих один элемент для каждой команды в пакете. Элементы массива упорядочены в соответствии с порядком добавления команд в пакет.
- Атрибуты
Исключения
Если ошибка возникает при доступе к базе данных.
Комментарии
Отправляет пакет команд в базу данных для выполнения, а если все команды выполняются успешно, возвращает массив счетчиков обновлений. Элементы 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.