DbDataAdapter.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 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.
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 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, muss die -Eigenschaft für alle Befehle, die dem DbDataAdapter zugeordnet sind, auf Keine oder OutputParameters festgelegt seinUpdatedRowSource. Andernfalls wird eine Ausnahme ausgelöst.
Hinweise
Verwenden Sie die UpdateBatchSize -Eigenschaft, um eine Datenquelle mit Änderungen aus einem DataSetzu aktualisieren. Wenn der Datenanbieter die Batchverarbeitung unterstützt, kann dies die Anwendungsleistung erhöhen, indem die Anzahl der Roundtrips zum Server reduziert wird. In ADO.NET 2.0 wird diese Eigenschaft für die .NET-Datenanbieter für SQL Server (SqlClient) und Oracle (OracleClient) unterstützt.
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.
