SqlDataAdapter.UpdateBatchSize Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Data.SqlClient
Zestaw:
System.Data.SqlClient.dll
Zestaw:
System.Data.dll
Pakiet:
System.Data.SqlClient v4.8.6

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

Int32

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.

Dotyczy

Zobacz też