Udostępnij za pośrednictwem


DbDataAdapter.UpdateBatchSize Właściwość

Definicja

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

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ż