SqlDataAdapter.UpdateBatchSize Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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, setPublic Overrides Property UpdateBatchSize As IntegerValeur de propriété
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.