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 przetwarzanych 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 wsadowo.
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 wartości innej niż 1 wszystkie polecenia skojarzone z właściwością SqlDataAdapterUpdatedRowSource mają ustawioną 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 można wykonać w partii.
Użyj właściwości , UpdateBatchSize aby zaktualizować źródło danych za pomocą 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.
Wartość ArgumentOutOfRangeException jest zgłaszana, jeśli wartość jest ustawiona na liczbę mniejszą niż zero.