DbBatch 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
表示一批可在一次往返中针对数据源执行的命令。 为表示命令批处理的数据库特定类提供基类。
public ref class DbBatch abstract : IAsyncDisposable, IDisposablepublic abstract class DbBatch : IAsyncDisposable, IDisposabletype DbBatch = class
interface IDisposable
interface IAsyncDisposablePublic MustInherit Class DbBatch
Implements IAsyncDisposable, IDisposable- 继承
-
DbBatch
- 实现
注解
批处理执行的精确语义因 ADO.NET 提供程序而异，尤其是在错误处理方面。 如果可能，建议批处理中的命令中出现错误会立即终止批处理，跳过所有后续命令，并回滚已执行的命令。 但是，跨数据库可能不支持此行为;请参阅 ADO.NET 提供商的文档。
构造函数
| DbBatch() |
初始化 DbBatch 类的新实例。 |
属性
| BatchCommands |
获取 DbBatchCommand 对象的集合。 |
| Connection |
获取或设置此 DbBatch使用的 DbConnection。 |
| DbBatchCommands |
在派生类中重写时，获取 DbBatchCommand 对象的集合。 |
| DbConnection |
在派生类中重写时，获取或设置此 DbBatch使用的 DbConnection。 |
| DbTransaction |
在派生类中重写时，获取或设置执行此 DbBatch 对象 DbTransaction。 |
| Timeout |
获取或设置等待时间（以秒为单位），然后终止尝试执行批处理并生成错误。 |
| Transaction |
获取或设置执行此 DbBatch 对象的 DbTransaction。 |
方法
| Cancel() |
尝试取消执行 DbBatch。 |
| CreateBatchCommand() |
创建 DbBatchCommand 对象的新实例。 |
| CreateDbBatchCommand() |
在派生类中重写时，创建 DbBatchCommand 对象的新实例。 |
| Dispose() |
执行与释放、释放或重置非托管资源关联的应用程序定义任务。 |
| DisposeAsync() |
异步地将批处理对象浸入。 |
| Equals(Object) |
确定指定的对象是否等于当前对象。 (继承自 Object) |
| ExecuteDbDataReader(CommandBehavior) |
在派生类中重写时，针对其连接执行批处理，返回可用于访问结果的 DbDataReader。 |
| ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) |
提供程序应实现此方法，为 ExecuteReader 重载提供非默认实现。 默认实现调用同步 ExecuteReader() 方法并返回已完成的任务，从而阻止调用线程。 如果传递已取消的取消令牌，则默认实现将返回已取消的任务。 ExecuteReader 引发的异常将通过返回的任务异常属性进行通信。 此方法接受一个取消令牌，该令牌可用于请求提前取消操作。 实现可能会忽略此请求。 |
| ExecuteNonQuery() |
对其连接对象执行批处理，返回所有批处理命令中受影响的行总数。 |
| ExecuteNonQueryAsync(CancellationToken) |
这是 ExecuteNonQuery()的异步版本。 提供程序应使用适当的实现替代。 可以选择忽略取消令牌。 默认实现调用同步 ExecuteNonQuery() 方法并返回已完成的任务，从而阻止调用线程。 如果传递已取消的取消令牌，则默认实现将返回已取消的任务。 ExecuteNonQuery() 引发的异常将通过返回的任务异常属性进行通信。 在返回的任务完成之前，请勿调用 |
| ExecuteReader(CommandBehavior) |
针对其连接执行批处理，返回可用于访问结果的 DbDataReader。 |
| ExecuteReaderAsync(CancellationToken) |
ExecuteReader的异步版本，该版本对其连接执行批处理，返回可用于访问结果的 DbDataReader。 |
| ExecuteReaderAsync(CommandBehavior, CancellationToken) |
ExecuteReader的异步版本，该版本对其连接执行批处理，返回可用于访问结果的 DbDataReader。 |
| ExecuteScalar() |
执行批处理，并返回第一个返回的结果集中第一行的第一列。 将忽略所有其他列、行和结果集。 |
| ExecuteScalarAsync(CancellationToken) |
ExecuteScalar()的异步版本，该版本执行批处理并返回第一个返回的结果集中第一行的第一列。 将忽略所有其他列、行和结果集。 |
| GetHashCode() |
用作默认哈希函数。 (继承自 Object) |
| GetType() |
获取当前实例的 Type。 (继承自 Object) |
| MemberwiseClone() |
创建当前 Object的浅表副本。 (继承自 Object) |
| Prepare() |
在数据源上创建批处理的已准备（或已编译）版本或其每个命令。 |
| PrepareAsync(CancellationToken) |
在数据源上异步创建批处理（或已编译）版本的批处理或其每个命令。 |
| ToString() |
返回一个表示当前对象的字符串。 (继承自 Object) |
扩展方法
| ConfigureAwait(IAsyncDisposable, Boolean) |
配置如何执行从异步可释放项返回的任务的 await。 |
