DbDataAdapter.UpdateBatchSize Propriété

  • Référence

Définition

Espace de noms:
System.Data.Common
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll
Source:
DbDataAdapter.cs
Source:
DbDataAdapter.cs
Source:
DbDataAdapter.cs

Obtient ou définit une valeur qui active ou désactive la prise en charge du traitement par lots et qui spécifie le nombre de commandes pouvant être exécutées dans un lot.

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

Valeur de propriété

Int32

Nombre de lignes à traiter par lot.

Valeur Effet
0 Il n'y a aucune limite à la taille du lot.
1 Désactive la mise à jour par lots.
> 1 Les modifications sont envoyées à l'aide de lots de UpdateBatchSize opérations à la fois.

Lorsque vous définissez cette valeur sur une valeur autre que 1, toutes les commandes associées à doivent DbDataAdapter avoir leur UpdatedRowSource propriété définie sur None ou OutputParameters. Sinon, une exception sera levée.

Remarques

Utilisez la UpdateBatchSize propriété pour mettre à jour une source de données avec les modifications d’un DataSet. Si le fournisseur de données prend en charge le traitement par lots, cela peut augmenter les performances de l’application en réduisant le nombre d’allers-retours vers le serveur. Dans ADO.NET 2.0, cette propriété est prise en charge pour les fournisseurs de données .NET pour SQL Server (SqlClient) et Oracle (OracleClient).

L'exécution d'un lot très volumineux peut réduire les performances. Vous devez donc tester le paramètre de taille de lot optimal avant d'implémenter votre application.

Un ArgumentOutOfRangeException est levée si la valeur est définie sur un nombre inférieur à zéro.

S’applique à

Voir aussi