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 , свойство должно UpdatedRowSource иметь значение None или OutputParameters. В противном случае будет выдаваться исключение.
Комментарии
Используйте свойство , UpdateBatchSize чтобы обновить источник данных с помощью изменений из DataSet. Если поставщик данных поддерживает пакетную обработку, это может повысить производительность приложения за счет уменьшения количества круговых путей к серверу. В ADO.NET 2.0 это свойство поддерживается поставщиками данных .NET для SQL Server (SqlClient) и Oracle (OracleClient).
Выполнение очень больших пакетов может снизить производительность. Поэтому необходимо экспериментальным путем найти параметр оптимального размера пакета перед реализацией приложения.
Если ArgumentOutOfRangeException для значения задано число меньше нуля, будет выдано исключение .
