DbDataAdapter.UpdateBatchSize DbDataAdapter.UpdateBatchSize DbDataAdapter.UpdateBatchSize DbDataAdapter.UpdateBatchSize Property

Définition

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.Gets or sets a value that enables or disables batch processing support, and specifies the number of commands that can be executed in a batch.

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é

Nombre de lignes à traiter par lot.The number of rows to process per batch.

ValeurValue is EffetEffect
00 Il n'y a aucune limite à la taille du lot.There is no limit on the batch size.
11 Désactive la mise à jour par lots.Disables batch updating.
> 1> 1 Les modifications sont envoyées à l'aide de lots de UpdateBatchSize opérations à la fois.Changes are sent using batches of UpdateBatchSize operations at a time.

Lorsque vous affectez à ce paramètre une DbDataAdapter valeur autre que 1, la UpdatedRowSource propriété de toutes les commandes associées à doit avoir la valeur None ou OutputParameters.When setting this to a value other than 1, all the commands associated with the DbDataAdapter must have their UpdatedRowSource property set to None or OutputParameters. Sinon, une exception sera levée.An exception will be thrown otherwise.

Remarques

Utilisez la UpdateBatchSize propriété pour mettre à jour une source de données avec DataSetles modifications apportées à un.Use the UpdateBatchSize property to update a data source with changes from a 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 au serveur.If the data provider supports batch processing, this can increase application performance by reducing the number of round-trips to the server. 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).In ADO.NET 2.0, this property is supported for the .NET data providers for SQL Server (SqlClient) and Oracle (OracleClient).

L'exécution d'un lot très volumineux peut réduire les performances.Executing an extremely large batch could decrease performance. Vous devez donc tester le paramètre de taille de lot optimal avant d'implémenter votre application.Therefore, you should test for the optimum batch size setting before implementing your application.

Une ArgumentOutOfRangeException est levée si la valeur est définie sur un nombre inférieur à zéro.An ArgumentOutOfRangeException will be thrown if the value is set to a number less than zero.

S’applique à

Voir aussi