SqlDataAdapter.UpdateBatchSize Eigenschaft

  • Referenz

Definition

Namespace:
System.Data.SqlClient
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll
Paket:
System.Data.SqlClient v4.8.6

Ruft die Anzahl der Zeilen ab, die in jedem Round-Trip zum Server verarbeitet werden, oder legt die Anzahl fest.

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

Eigenschaftswert

Int32

Die Anzahl der Zeilen, die pro Batch verarbeitet werden.

Wert Auswirkung
0 Es gibt keine Beschränkung für die Batchgröße.
1 Deaktiviert die Batchaktualisierung.
>1 Änderungen werden mit Batches von UpdateBatchSize-Operationen gleichzeitig übertragen.

Wenn Sie dies auf einen anderen Wert als 1 festlegen, müssen alle Befehle, die dem SqlDataAdapter zugeordnet sind, ihre UpdatedRowSource-Eigenschaft auf None oder OutputParametersfestgelegt haben. Andernfalls wird eine Ausnahme ausgelöst.

Hinweise

Ruft einen Wert ab oder legt einen Wert fest, mit dem die Batchverarbeitung aktiviert bzw. deaktiviert wird, und gibt die Anzahl der Befehle an, die pro Batch ausgeführt werden können.

Verwenden Sie die UpdateBatchSize -Eigenschaft, um eine Datenquelle mit Änderungen aus einem DataSetzu aktualisieren. Dies kann die Anwendungsleistung erhöhen, indem die Anzahl von Roundtrips zum Server reduziert wird.

Die Ausführung eines extrem großen Batches könnte die Leistung verringern. Daher sollten Sie die Einstellung für eine optimale Batchgröße vor der Implementierung Ihrer Anwendung austesten.

Ein ArgumentOutOfRangeException wird ausgelöst, wenn der Wert auf eine Zahl kleiner als 0 (null) festgelegt ist.

Gilt für:

Weitere Informationen