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, setPublic Overrides Property UpdateBatchSize As IntegerКоличество строк, которые необходимо обработать с помощью одного пакета.
| Значение | Действие |
|---|---|
| 0 | Размер пакета не ограничен. |
| 1 | Отключает пакетное обновление. |
| >1 | Изменения отправляются с помощью пакетов, единовременное количество операций в которых определяется свойством UpdateBatchSize. |
При установке значения, отличного от 1, все команды, связанные с SqlDataAdapter , должны иметь свойство UpdatedRowSource , равное None или OutputParameters. В противном случае возникает исключение.
Возвращает или задает значение, которое включает или отключает поддержку пакетной обработки и задает количество команд, которые могут выполняться в рамках одного пакета.
Используйте свойство , UpdateBatchSize чтобы обновить источник данных с помощью изменений из DataSet. Это может повысить производительность приложения, уменьшив количество обращений к серверу.
Выполнение очень больших пакетов может снизить производительность. Поэтому необходимо экспериментальным путем найти параметр оптимального размера пакета перед реализацией приложения.
Если ArgumentOutOfRangeException для значения задано число меньше нуля, возникает исключение .
Применяется к
| Продукт | Версии |
|---|---|
| .NET | 6 (package-provided), 7 (package-provided), 8 (package-provided), 9 (package-provided), 10 (package-provided) |
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0 (package-provided) |
