DbDataAdapter.UpdateBatchSize Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Data.Common
Zestaw:
System.Data.Common.dll
Zestaw:
System.Data.dll
Zestaw:
netstandard.dll
Źródło:
DbDataAdapter.cs
Źródło:
DbDataAdapter.cs
Źródło:
DbDataAdapter.cs

Pobiera lub ustawia wartość, która włącza lub wyłącza obsługę przetwarzania wsadowego i określa liczbę poleceń, które mogą być wykonywane w partii.

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

Wartość właściwości

Int32

Liczba wierszy do przetworzenia na partię.

Wartość to Efekt
0 Nie ma limitu rozmiaru partii.
1 Wyłącza aktualizowanie wsadowe.
> 1 Zmiany są wysyłane przy użyciu partii UpdateBatchSize operacji naraz.

W przypadku ustawienia tej wartości na wartość inną niż 1 wszystkie polecenia skojarzone z DbDataAdapter właściwością muszą mieć ustawioną UpdatedRowSource właściwość None lub OutputParameters. Wyjątek zostanie zgłoszony w przeciwnym razie.

Uwagi

UpdateBatchSize Użyj właściwości , aby zaktualizować źródło danych przy użyciu zmian z elementu DataSet. Jeśli dostawca danych obsługuje przetwarzanie wsadowe, może to zwiększyć wydajność aplikacji, zmniejszając liczbę rund na serwerze. W ADO.NET 2.0 ta właściwość jest obsługiwana dla dostawców danych platformy .NET dla SQL Server (SqlClient) i Oracle (OracleClient).

Wykonanie bardzo dużej partii może zmniejszyć wydajność. W związku z tym należy przetestować optymalne ustawienie rozmiaru partii przed wdrożeniem aplikacji.

Wartość ArgumentOutOfRangeException zostanie wyrzucona, jeśli wartość jest ustawiona na liczbę mniejszą niż zero.

Dotyczy

Zobacz też