Bagikan melalui


IStatement.ExecuteBatch Metode

Definisi

Mengirimkan batch perintah ke database untuk dieksekusi dan jika semua perintah berhasil dijalankan, mengembalikan array jumlah pembaruan.

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

Mengembalikan

Int32[]

array jumlah pembaruan yang berisi satu elemen untuk setiap perintah dalam batch. Elemen array diurutkan sesuai dengan urutan di mana perintah ditambahkan ke batch.

Atribut

Pengecualian

jika terjadi kesalahan saat mengakses database.

Keterangan

Mengirimkan batch perintah ke database untuk dieksekusi dan jika semua perintah berhasil dijalankan, mengembalikan array jumlah pembaruan. Elemen int array yang dikembalikan diurutkan sesuai dengan perintah dalam batch, yang diurutkan sesuai dengan urutan yang ditambahkan ke batch. Elemen dalam array yang dikembalikan oleh metode executeBatch mungkin salah satu dari berikut ini: <Angka OL<>LI>A yang lebih besar dari atau sama dengan nol -- menunjukkan bahwa perintah berhasil diproses dan merupakan jumlah pembaruan yang memberikan jumlah baris dalam database yang terpengaruh oleh eksekusi <perintah LI>Nilai SUCCESS_NO_INFO -- menunjukkan bahwa perintah berhasil diproses tetapi jumlah baris yang terpengaruh tidak diketahui

Jika salah satu perintah dalam pembaruan batch gagal dijalankan dengan benar, metode ini melemparkan BatchUpdateException, dan driver JDBC mungkin atau mungkin tidak terus memproses perintah yang tersisa dalam batch. Namun, perilaku driver harus konsisten dengan DBMS tertentu, baik selalu terus memproses perintah atau tidak pernah terus memproses perintah. Jika driver terus memproses setelah kegagalan, array yang dikembalikan oleh metode BatchUpdateException.getUpdateCounts akan berisi elemen sebanyak ada perintah dalam batch, dan setidaknya salah satu elemen adalah sebagai berikut:

<LI>Nilai - EXECUTE_FAILED - menunjukkan bahwa perintah gagal dijalankan dengan sukses dan hanya terjadi jika driver terus memproses perintah setelah perintah gagal </OL>

Kemungkinan implementasi dan nilai pengembalian telah dimodifikasi dalam Java 2 SDK, Edisi Standar, versi 1.3 untuk mengakomodasi opsi untuk terus memproksi perintah dalam pembaruan batch setelah BatchUpdateException obejct dilemparkan.

Ditambahkan dalam 1.2.

Dokumentasi Java untuk java.sql.Statement.executeBatch().

Bagian halaman ini adalah modifikasi berdasarkan pekerjaan yang dibuat dan dibagikan oleh Proyek Sumber Terbuka Android dan digunakan sesuai dengan istilah yang dijelaskan dalam Lisensi Atribusi Creative Commons 2.5.

Berlaku untuk