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 Roundtrip zum Server verarbeitet werden, oder legt diese 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 sollen.
| Wert ist | Effekt |
|---|---|
| 0 | Die Batchgröße ist nicht begrenzt. |
| 1 | Deaktiviert die Batchaktualisierung. |
| >1 | Änderungen werden jeweils mithilfe von Batches von UpdateBatchSize Vorgängen gesendet. |
Wenn Sie dies auf einen anderen Wert als 1 festlegen, müssen alle Befehle, die der SqlDataAdapterUpdatedRowSource-Eigenschaft zugeordnet sind, auf None oder OutputParametersfestgelegt sein. Andernfalls wird eine Ausnahme ausgelöst.
Hinweise
Dient zum Abrufen oder Festlegen eines Werts, der die Batchverarbeitungsunterstützung aktiviert oder deaktiviert, und gibt die Anzahl der Befehle an, die in einem Batch ausgeführt werden können.
Verwenden Sie die UpdateBatchSize Eigenschaft, um eine Datenquelle mit Änderungen von einer DataSet. Dies kann die Anwendungsleistung erhöhen, indem die Anzahl der 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 Fehler wird ausgelöst, wenn der Wert auf eine Zahl kleiner als 0 festgelegt ist.
