SqlDataAdapter.UpdateBatchSize Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera lub ustawia liczbę wierszy, które są przetwarzane w każdej rundzie na serwerze.
public:
virtual property int UpdateBatchSize { int get(); void set(int value); };
public override int UpdateBatchSize { get; set; }
member this.UpdateBatchSize : int with get, set
Public Overrides Property UpdateBatchSize As Integer
Wartość właściwości
Liczba wierszy do przetworzenia wsadowego.
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 właściwością SqlDataAdapter UpdatedRowSource mają ustawioną właściwość UpdatedRowSource na None
wartość lub OutputParameters
. Wyjątek jest zgłaszany w przeciwnym razie.
Uwagi
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.
UpdateBatchSize Użyj właściwości , aby zaktualizować źródło danych przy użyciu zmian z elementu DataSet. Może to zwiększyć wydajność aplikacji, zmniejszając liczbę rund na serwerze.
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.
Element ArgumentOutOfRangeException jest zgłaszany, jeśli wartość jest ustawiona na liczbę mniejszą niż zero.