DbDataAdapter.UpdateBatchSize Eigenschaft

  • Referenz

Definition

Namespace:
System.Data.Common
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll
Quelle:
DbDataAdapter.cs
Quelle:
DbDataAdapter.cs
Quelle:
DbDataAdapter.cs

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, set
Public Overridable 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, 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.

Gilt für:

Weitere Informationen