DbDataAdapter.UpdateBatchSize Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение, которое включает или отключает поддержку пакетной обработки и задает количество команд, которые можно выполнить в пакете.
public:
virtual property int UpdateBatchSize { int get(); void set(int value); };public virtual int UpdateBatchSize { get; set; }member this.UpdateBatchSize : int with get, setPublic Overridable Property UpdateBatchSize As IntegerЗначение свойства
Количество строк для обработки на каждый пакет.
| Значение равно | Эффект |
|---|---|
| 0 | Размер пакета не ограничен. |
| 1 | Отключает пакетное обновление. |
| > 1 | Изменения отправляются с помощью пакетов операций UpdateBatchSize за раз. |
При задании значения, отличного от 1, все команды, связанные с DbDataAdapter ним, должны иметь значение UpdatedRowSourceNone или OutputParameters. Исключение будет создано в противном случае.
Комментарии
UpdateBatchSize Используйте свойство для обновления источника данных с изменениями из DataSet. Если поставщик данных поддерживает пакетную обработку, это может повысить производительность приложения, уменьшая количество циклов передачи на сервер. В ADO.NET 2.0 это свойство поддерживается для поставщиков данных .NET для SQL Server (SqlClient) и Oracle (OracleClient).
Выполнение очень больших пакетов может снизить производительность. Поэтому необходимо экспериментальным путем найти параметр оптимального размера пакета перед реализацией приложения.
Вызывается ArgumentOutOfRangeException , если для значения задано число меньше нуля.
