DbDataAdapter.UpdateBatchSize Свойство

Определение

Возвращает или задает значение, которое включает или отключает поддержку пакетной обработки и задает количество команд, которые могут выполняться в рамках одного пакета.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

Значение свойства

Int32

Количество строк, которые необходимо обработать с помощью одного пакета.The number of rows to process per batch.

ЗначениеValue is ДействиеEffect
00 Размер пакета не ограничен.There is no limit on the batch size.
11 Отключает пакетное обновление.Disables batch updating.
> одного> 1 Изменения отправляются с помощью пакетов, единовременное количество операций в которых определяется свойством UpdateBatchSize.Changes are sent using batches of UpdateBatchSize operations at a time.

При присвоении этому свойству значения, отличного от 1, для всех команд, связанных с, DbDataAdapter свойство должно иметь значение UpdatedRowSource None или аутпутпараметерс.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. В противном случае будет выдаваться исключение.An exception will be thrown otherwise.

Комментарии

Используйте UpdateBatchSize свойство, чтобы обновить источник данных изменениями из DataSet .Use the UpdateBatchSize property to update a data source with changes from a DataSet. Если поставщик данных поддерживает пакетную обработку, это может повысить производительность приложения, уменьшая количество обращений к серверу.If the data provider supports batch processing, this can increase application performance by reducing the number of round-trips to the server. В ADO.NET 2,0 это свойство поддерживается для поставщиков данных .NET для SQL Server (SqlClient) и Oracle (OracleClient).In ADO.NET 2.0, this property is supported for the .NET data providers for SQL Server (SqlClient) and Oracle (OracleClient).

Выполнение очень больших пакетов может снизить производительность.Executing an extremely large batch could decrease performance. Поэтому необходимо экспериментальным путем найти параметр оптимального размера пакета перед реализацией приложения.Therefore, you should test for the optimum batch size setting before implementing your application.

ArgumentOutOfRangeExceptionЕсли в качестве значения задано число меньше нуля, будет создано исключение.An ArgumentOutOfRangeException will be thrown if the value is set to a number less than zero.

Применяется к

См. также раздел