DbDataAdapter.UpdateBatchSize Özellik
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Toplu işlem desteğini etkinleştiren veya devre dışı bırakabilen bir değeri alır veya ayarlar ve toplu işlemde yürütülebilecek komut sayısını belirtir.
public:
virtual property int UpdateBatchSize { int get(); void set(int value); };
public virtual int UpdateBatchSize { get; set; }
member this.UpdateBatchSize : int with get, set
Public Overridable Property UpdateBatchSize As Integer
Özellik Değeri
Toplu iş başına işlenmek üzere satır sayısı.
Değer: | Etki |
---|---|
0 | Toplu iş boyutu sınırı yoktur. |
1 | Toplu güncelleştirmeyi devre dışı bırakır. |
> 1 | Değişiklikler bir kerede toplu UpdateBatchSize işlemler kullanılarak gönderilir. |
Bunu 1 dışında bir değere ayarlarken, ile DbDataAdapter ilişkili tüm komutların özellikleri None veya OutputParameters olarak ayarlanmalıdırUpdatedRowSource. Aksi takdirde bir özel durum oluşturulur.
Açıklamalar
Bir veri kaynağını bir dosyasından UpdateBatchSizeDataSetyapılan değişikliklerle güncelleştirmek için özelliğini kullanın. Veri sağlayıcısı toplu işlemeyi destekliyorsa bu, sunucuya gidiş dönüş sayısını azaltarak uygulama performansını artırabilir. ADO.NET 2.0'da, bu özellik SQL Server (SqlClient) ve Oracle (OracleClient) için .NET veri sağlayıcıları için desteklenir.
Son derece büyük bir toplu iş yürütmek performansı düşürebilir. Bu nedenle, uygulamanızı uygulamadan önce en uygun toplu iş boyutu ayarını test etmeniz gerekir.
ArgumentOutOfRangeException Değer sıfırdan küçük bir sayıya ayarlanırsa bir oluşturulur.