SqlDataAdapter.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 mengatur jumlah baris yang diproses di setiap perjalanan pulang-pergi ke server.
public:
virtual property int UpdateBatchSize { int get(); void set(int value); };
public override int UpdateBatchSize { get; set; }
member this.UpdateBatchSize : int with get, set
Public Overrides Property UpdateBatchSize As Integer
Nilai 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 SqlDataAdapter harus mengatur properti UpdatedRowSource mereka ke None
atau OutputParameters
. Pengecualian dilemparkan sebaliknya.
Keterangan
Mendapatkan atau menetapkan nilai yang mengaktifkan atau menonaktifkan dukungan pemrosesan batch, dan menentukan jumlah perintah yang dapat dijalankan dalam batch.
UpdateBatchSize Gunakan properti untuk memperbarui sumber data dengan perubahan dari DataSet. Ini dapat meningkatkan performa aplikasi dengan mengurangi jumlah perjalanan pulang pergi ke server.
Mengeksekusi batch yang sangat besar dapat mengurangi performa. Oleh karena itu, Anda harus menguji pengaturan ukuran batch optimal sebelum menerapkan aplikasi Anda.
ArgumentOutOfRangeException dilemparkan jika nilai diatur ke angka kurang dari nol.