DbDataAdapter.UpdateBatchSize Свойство

  • Ссылка

Определение

Пространство имен:
System.Data.Common
Сборка:
System.Data.Common.dll
Сборка:
System.Data.dll
Сборка:
netstandard.dll
Исходный код:
DbDataAdapter.cs
Исходный код:
DbDataAdapter.cs
Исходный код:
DbDataAdapter.cs

Возвращает или задает значение, которое включает или отключает поддержку пакетной обработки и задает количество команд, которые могут выполняться в рамках одного пакета.

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

Количество строк, которые необходимо обработать с помощью одного пакета.

Значение Действие
0 Размер пакета не ограничен.
1 Отключает пакетное обновление.
> 1 Изменения отправляются с помощью пакетов, единовременное количество операций в которых определяется свойством UpdateBatchSize.

Если для этого параметра задано значение, отличное от 1, для всех команд, связанных с DbDataAdapter , свойство должно UpdatedRowSource иметь значение None или OutputParameters. В противном случае будет выдаваться исключение.

Комментарии

Используйте свойство , UpdateBatchSize чтобы обновить источник данных с помощью изменений из DataSet. Если поставщик данных поддерживает пакетную обработку, это может повысить производительность приложения за счет уменьшения количества круговых путей к серверу. В ADO.NET 2.0 это свойство поддерживается поставщиками данных .NET для SQL Server (SqlClient) и Oracle (OracleClient).

Выполнение очень больших пакетов может снизить производительность. Поэтому необходимо экспериментальным путем найти параметр оптимального размера пакета перед реализацией приложения.

Если ArgumentOutOfRangeException для значения задано число меньше нуля, будет выдано исключение .

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

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