IStatement.ExecuteBatch Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
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.