DbDataAdapter.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 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, setPublic Overridable 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 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.
