SqlDataAdapter.UpdateBatchSize Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Data.SqlClient
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll
Pacchetto:
System.Data.SqlClient v4.8.6

Ottiene o imposta il numero di righe elaborate in ogni percorso andata-ritorno al server.

public:
 virtual property int UpdateBatchSize { int get(); void set(int value); };
public override int UpdateBatchSize { get; set; }
member this.UpdateBatchSize : int with get, set
Public Overrides Property UpdateBatchSize As Integer

Valore della proprietà

Int32

Numero delle righe da elaborare per ogni 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 questo valore su un valore diverso da 1, tutti i comandi associati all'oggetto SqlDataAdapter devono avere la proprietà UpdateRowSource impostata su None o OutputParameters. In caso contrario, viene generata un'eccezione.

Commenti

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.

Usare la proprietà per aggiornare un'origine UpdateBatchSize dati con modifiche da un oggetto DataSet. Ciò può aumentare le prestazioni dell'applicazione riducendo il numero di round trip nel server.

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.

Viene ArgumentOutOfRangeException generato se il valore è impostato su un numero minore di zero.

Si applica a

Vedi anche