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, setPublic 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如果值设置为小于零的数字，则会引发 。
| 产品 | 版本 |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .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, 2.1 |
