SqlBulkCopy.BatchSize Özellik

Tanım

Ad Alanı:

Microsoft.Data.SqlClient

Bütünleştirilmiş Kod:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Her toplu işlemdeki satır sayısı. Her toplu iş sonunda, toplu iş içindeki satırlar sunucuya gönderilir.

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

Özellik Değeri

Int32

Özelliğin BatchSize tamsayı değeri veya değer ayarlanmamışsa sıfır.

Örnekler

Aşağıdaki konsol uygulaması, verileri 50 satırlık toplu olarak toplu olarak yüklemeyi gösterir. Bir işlemle nasıl BatchSize çalıştığını gösteren bir örnek için bkz. İşlem ve Toplu Kopyalama İşlemleri.

Önemli

İş tablolarını Toplu Kopyalama Örneği Kurulumu'nda açıklandığı gibi oluşturmadığınız sürece bu örnek çalışmaz. Bu kod, yalnızca SqlBulkCopy kullanımına yönelik söz dizimini göstermek için sağlanır. Kaynak ve hedef tablolar aynı SQL Server örnekteyse, verileri kopyalamak için Transact-SQL INSERT … SELECT deyimi kullanmak daha kolay ve daha hızlıdır.

Açıklamalar

Satırlar işlendiğinde veya hedef veri kaynağına gönderilecek başka satır kalmadığında BatchSize toplu iş tamamlanır.

Sıfır (varsayılan), her WriteToServer işlemin tek bir toplu iş olduğunu gösterir.

SqlBulkCopy Örnek, seçenek geçerli olmadan UseInternalTransaction bildirilmişse, satırlar sunucu BatchSize satırlarına bir kerede gönderilir, ancak işlemle ilgili bir işlem yapılmaz. Etkinse UseInternalTransaction , her satır toplu işlemi ayrı bir işlem olarak eklenir.

BatchSize özelliği istediğiniz zaman ayarlanabilir. Toplu kopyalama devam ediyorsa, geçerli toplu iş önceki toplu iş boyutuna göre boyutlandırılır. Sonraki toplu işlemler yeni boyutu kullanır. BatchSize başlangıçta sıfır ise ve bir WriteToServer işlem devam ederken değiştirildiyse, bu işlem verileri tek bir toplu iş olarak yükler. Aynı SqlBulkCopy örnekteki sonraki WriteToServer işlemler yeni BatchSizekullanır.