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 | Effekt |
|---|---|
| 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 der DbDataAdapter Eigenschaft zugeordnet sind, auf "None" oder "OutputParameters" festgelegt seinUpdatedRowSource. Andernfalls wird eine Ausnahme ausgelöst.
Hinweise
Verwenden Sie die UpdateBatchSize Eigenschaft, um eine Datenquelle mit Änderungen von einer DataSet. Wenn der Datenanbieter die Batchverarbeitung unterstützt, kann dies die Anwendungsleistung erhöhen, indem die Anzahl der Roundtrips auf den 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.
Wird ArgumentOutOfRangeException ausgelöst, wenn der Wert auf eine Zahl kleiner als null festgelegt ist.