SqlBulkCopy.BatchSize Properti

Definisi

Ruang nama:

Microsoft.Data.SqlClient

Rakitan:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Jumlah baris di setiap batch. Di akhir setiap batch, baris dalam batch dikirim ke server.

public:
 property int BatchSize { int get(); void set(int value); };

public int BatchSize { get; set; }

member this.BatchSize : int with get, set

Public Property BatchSize As Integer

Nilai Properti

Int32

Nilai bilangan BatchSize bulat properti, atau nol jika tidak ada nilai yang ditetapkan.

Contoh

Aplikasi konsol berikut menunjukkan cara memuat data secara massal dalam batch 50 baris. Untuk contoh yang mengilustrasikan cara BatchSize kerja transaksi, lihat Operasi Transaksi dan Salin Massal.

Penting

Sampel ini tidak akan berjalan kecuali Anda telah membuat tabel kerja seperti yang dijelaskan dalam Penyiapan Contoh Salinan Massal. Kode ini disediakan untuk mendemonstrasikan sintaks untuk menggunakan SqlBulkCopy saja. Jika tabel sumber dan tujuan berada dalam instans SQL Server yang sama, lebih mudah dan lebih cepat untuk menggunakan pernyataan Transact-SQL INSERT … SELECT untuk menyalin data.

Keterangan

Batch selesai ketika BatchSize baris telah diproses atau tidak ada lagi baris untuk dikirim ke sumber data tujuan.

Nol (default) menunjukkan bahwa setiap WriteToServer operasi adalah satu batch.

SqlBulkCopy Jika instans telah dinyatakan tanpa UseInternalTransaction opsi berlaku, baris dikirim ke baris server BatchSize pada satu waktu, tetapi tidak ada tindakan terkait transaksi yang diambil. Jika UseInternalTransaction berlaku, setiap batch baris disisipkan sebagai transaksi terpisah.

Properti BatchSize dapat diatur kapan saja. Jika salinan massal sudah berlangsung, batch saat ini berukuran sesuai dengan ukuran batch sebelumnya. Batch berikutnya menggunakan ukuran baru. BatchSize Jika awalnya nol dan berubah saat WriteToServer operasi sudah berlangsung, operasi tersebut memuat data sebagai satu batch. Setiap operasi berikutnya WriteToServer pada instans yang sama SqlBulkCopy menggunakan yang baru BatchSize.