SqlDataAdapter.UpdateBatchSize Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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, setPublic Overrides Property UpdateBatchSize As IntegerEigenschaftswert
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.