DbBatch 类

定义

命名空间:

System.Data.Common

程序集:

System.Data.Common.dll

Source:

DbBatch.cs

表示一批可在一次往返中针对数据源执行的命令。 为表示命令批处理的数据库特定类提供基类。

public ref class DbBatch abstract : IAsyncDisposable, IDisposable

public abstract class DbBatch : IAsyncDisposable, IDisposable

type DbBatch = class
    interface IDisposable
    interface IAsyncDisposable

Public MustInherit Class DbBatch
Implements IAsyncDisposable, IDisposable

继承

Object

DbBatch

实现

IAsyncDisposable IDisposable

注解

批处理执行的精确语义因 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() 引发的异常将通过返回的任务异常属性进行通信。 在返回的任务完成之前，请勿调用 DbCommand 对象的其他方法和属性。
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。