DbDataAdapter.UpdateBatchSize Eigenschaft

Definition

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.Gets or sets a value that enables or disables batch processing support, and specifies the number of commands that can be executed in a batch.

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

Die Anzahl der Zeilen, die pro Batch verarbeitet werden.The number of rows to process per batch.

WertValue is EffektEffect
00 Es gibt keine Beschränkung für die Batchgröße.There is no limit on the batch size.
11 Deaktiviert die Batchaktualisierung.Disables batch updating.
> 1> 1 Änderungen werden mit Batches von UpdateBatchSize-Operationen gleichzeitig übertragen.Changes are sent using batches of UpdateBatchSize operations at a time.

Wenn Sie diese Einstellung auf einen anderen Wert als 1 festlegen, muss für alle Befehle DbDataAdapter , die dem UpdatedRowSource zugeordnet sind, die-Eigenschaft auf None oder OutputParametersfestgelegt sein.When setting this to a value other than 1, all the commands associated with the DbDataAdapter must have their UpdatedRowSource property set to None or OutputParameters. Andernfalls wird eine Ausnahme ausgelöst.An exception will be thrown otherwise.

Hinweise

Verwenden Sie UpdateBatchSize die-Eigenschaft, um eine Datenquelle mit Änderungen DataSetvon einem zu aktualisieren.Use the UpdateBatchSize property to update a data source with changes from a DataSet. Wenn der Datenanbieter die Batch Verarbeitung unterstützt, kann dies die Anwendungsleistung erhöhen, indem die Anzahl der Roundtrips zum Server reduziert wird.If the data provider supports batch processing, this can increase application performance by reducing the number of round-trips to the server. In ADO.NET 2,0 wird diese Eigenschaft für die .NET-Datenanbieter für SQL Server (SqlClient) und Oracle (OracleClient) unterstützt.In ADO.NET 2.0, this property is supported for the .NET data providers for SQL Server (SqlClient) and Oracle (OracleClient).

Die Ausführung eines extrem großen Batches könnte die Leistung verringern.Executing an extremely large batch could decrease performance. Daher sollten Sie die Einstellung für eine optimale Batchgröße vor der Implementierung Ihrer Anwendung austesten.Therefore, you should test for the optimum batch size setting before implementing your application.

Eine ArgumentOutOfRangeException wird ausgelöst, wenn der Wert auf eine Zahl kleiner als 0 (null) festgelegt ist.An ArgumentOutOfRangeException will be thrown if the value is set to a number less than zero.

Gilt für:

Siehe auch