DbDataAdapter.UpdateBatchSize Properti
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.
Mendapatkan atau menetapkan nilai yang mengaktifkan atau menonaktifkan dukungan pemrosesan batch, dan menentukan jumlah perintah yang dapat dijalankan dalam batch.
public:
virtual property int UpdateBatchSize { int get(); void set(int value); };public virtual int UpdateBatchSize { get; set; }member this.UpdateBatchSize : int with get, setPublic Overridable Property UpdateBatchSize As IntegerNilai Properti
Jumlah baris yang akan diproses per batch.
| Nilainya adalah | Efek |
|---|---|
| 0 | Tidak ada batasan pada ukuran batch. |
| 1 | Menonaktifkan pembaruan batch. |
| > 1 | Perubahan dikirim menggunakan batch UpdateBatchSize operasi pada satu waktu. |
Saat mengatur ini ke nilai selain 1, semua perintah yang terkait dengan DbDataAdapter harus mengatur propertinya UpdatedRowSource ke Tidak Ada atau OutputParameters. Pengecualian akan dilemparkan sebaliknya.
Keterangan
UpdateBatchSize Gunakan properti untuk memperbarui sumber data dengan perubahan dari DataSet. Jika penyedia data mendukung pemrosesan batch, ini dapat meningkatkan performa aplikasi dengan mengurangi jumlah perjalanan pulang-pergi ke server. Di ADO.NET 2.0, properti ini didukung untuk penyedia data .NET untuk SQL Server (SqlClient) dan Oracle (OracleClient).
Mengeksekusi batch yang sangat besar dapat mengurangi performa. Oleh karena itu, Anda harus menguji pengaturan ukuran batch optimal sebelum menerapkan aplikasi Anda.
ArgumentOutOfRangeException Akan dilemparkan jika nilai diatur ke angka kurang dari nol.
