DbDataAdapter.UpdateBatchSize 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取或设置一个值,该值启用或禁用批处理支持,并且指定可在一次批处理中执行的命令的数量。
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
属性值
每个批处理要处理的行数。
值为 | 效果 |
---|---|
0 | 批大小没有限制。 |
1 | 禁用批量更新。 |
> 1 | 更改是使用 UpdateBatchSize 操作的批处理一次性发送的。 |
将其设置为 1 以外的值时,与 DbDataAdapter 关联的所有命令都必须将其 UpdatedRowSource 属性设置为 None 或 OutputParameters。 否则,将引发异常。
注解
UpdateBatchSize使用 属性使用 中的DataSet更改更新数据源。 如果数据提供程序支持批处理,这可以通过减少到服务器的往返次数来提高应用程序性能。 在 ADO.NET 2.0 中,SQL Server (SqlClient) 和 Oracle (OracleClient) 的 .NET 数据提供程序支持此属性。
执行极大的批处理会降低性能。 因此,在实现应用程序前应进行测试以得到最佳的批大小。
ArgumentOutOfRangeException如果值设置为小于零的数字,则会引发 。