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 traitées dans chaque aller-retour vers le 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.
| La valeur est | Effect |
|---|---|
| 0 | La taille du lot n’est pas limitée. |
| 1 | Désactive la mise à jour par lots. |
| >1 | Les modifications sont envoyées à l’aide de lots d’opérations UpdateBatchSize à la fois. |
Lorsque vous définissez cette valeur sur une valeur autre que 1, toutes les commandes associées à la SqlDataAdapter propriété UpdatedRowSource doivent être définies None sur 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 spécifie le nombre de commandes qui peuvent être exécutées dans un lot.
Utilisez la UpdateBatchSize propriété pour mettre à jour une source de données avec des 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.
Une ArgumentOutOfRangeException valeur est levée si la valeur est définie sur un nombre inférieur à zéro.
