DbDataAdapter.UpdateBatchSize Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta un valore che abilita o disabilita il supporto per l'elaborazione batch e specifica il numero di comandi che è possibile eseguire in un batch.
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 IntegerValore della proprietà
Numero di righe da elaborare per batch.
| Il valore è | Effect |
|---|---|
| 0 | Non esiste alcun limite per le dimensioni del batch. |
| 1 | Disabilita l'aggiornamento in batch. |
| > 1 | Le modifiche vengono inviate usando batch di UpdateBatchSize operazioni alla volta. |
Quando si imposta questa proprietà su un valore diverso da 1, tutti i comandi associati a DbDataAdapter devono avere la proprietà UpdatedRowSource impostata su Nessuno o OutputParameters. In caso contrario, verrà generata un'eccezione.
Commenti
Utilizzare la UpdateBatchSize proprietà per aggiornare un'origine dati con modifiche da un oggetto DataSet. Se il provider di dati supporta l'elaborazione batch, questo può migliorare le prestazioni dell'applicazione riducendo il numero di round trip al server. In ADO.NET 2.0 questa proprietà è supportata per i provider di dati .NET per SQL Server (SqlClient) e Oracle (OracleClient).
Le prestazioni risulteranno ridotte se si esegue un batch di dimensioni molto elevate. Pertanto, prima di implementare l'applicazione è consigliabile verificare quale sia la dimensione ottimale per i batch.
Verrà generata un'eccezione ArgumentOutOfRangeException se il valore è impostato su un numero minore di zero.
