SqlDataAdapter.UpdateBatchSize Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает число строк, обработанных при каждом обращении к серверу.
public:
virtual property int UpdateBatchSize { int get(); void set(int value); };
public override int UpdateBatchSize { get; set; }
member this.UpdateBatchSize : int with get, set
Public Overrides Property UpdateBatchSize As Integer
Значение свойства
Количество строк, которые необходимо обработать с помощью одного пакета.
Значение | Действие |
---|---|
0 | Размер пакета не ограничен. |
1 | Отключает пакетное обновление. |
>1 | Изменения отправляются с помощью пакетов, единовременное количество операций в которых определяется свойством UpdateBatchSize. |
При установке значения, отличного от 1, все команды, связанные с SqlDataAdapter , должны иметь свойство UpdatedRowSource , равное None
или OutputParameters
. В противном случае возникает исключение.
Комментарии
Возвращает или задает значение, которое включает или отключает поддержку пакетной обработки и задает количество команд, которые могут выполняться в рамках одного пакета.
Используйте свойство , UpdateBatchSize чтобы обновить источник данных с помощью изменений из DataSet. Это может повысить производительность приложения, уменьшив количество обращений к серверу.
Выполнение очень больших пакетов может снизить производительность. Поэтому необходимо экспериментальным путем найти параметр оптимального размера пакета перед реализацией приложения.
Если ArgumentOutOfRangeException для значения задано число меньше нуля, возникает исключение .