SqlDataAdapter.UpdateBatchSize Propriété

  • Référence

Définition

Espace de noms:
System.Data.SqlClient
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll
Paquet:
System.Data.SqlClient v4.8.6

Obtient ou définit le nombre de lignes qui sont traitées lors de chaque aller-retour au serveur.

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

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 SqlDataAdapter avoir leur propriété UpdatedRowSource définie sur None ou OutputParameters. Sinon, une exception est levée.

Remarques

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.

Utilisez la UpdateBatchSize propriété pour mettre à jour une source de données avec les modifications d’un DataSet. Cela peut augmenter les performances de l’application en réduisant le nombre d’allers-retours vers le serveur.

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