DbDataAdapter.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 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, setPublic Overridable Property UpdateBatchSize As IntegerWartość 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.
