DbDataAdapter.UpdateBatchSize Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Data.Common
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll
Source:
DbDataAdapter.cs
Source:
DbDataAdapter.cs
Source:
DbDataAdapter.cs

Ottiene o imposta un valore che attiva o disabilita il supporto dell'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, set
Public Overridable Property UpdateBatchSize As Integer

Valore della proprietà

Int32

Numero di righe da elaborare per batch.

Il valore è Effetto
0 Non è previsto nessun limite per la dimensione del batch.
1 Disabilita l'aggiornamento batch.
> 1 Le modifiche vengono inviate utilizzando i batch delle operazioni UpdateBatchSize di un determinato momento.

Quando si imposta questa proprietà su un valore diverso da 1, tutti i comandi associati a DbDataAdapter devono avere la relativa UpdatedRowSource proprietà impostata su Nessuno o OutputParameters. In caso contrario, viene generata un'eccezione.

Commenti

Utilizzare la proprietà per aggiornare un'origine UpdateBatchSize dati con modifiche da un oggetto DataSet. Se il provider di dati supporta l'elaborazione batch, ciò può aumentare 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.

Si applica a

Vedi anche