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	获取或设置此 DbConnection 使用的 DbBatch。
DbBatchCommands	在派生类中重写时，获取 DbBatchCommand 对象的集合。
DbConnection	当在派生类中重写时，获取或设置此 DbBatch 使用的 DbConnection。
DbTransaction	当在派生类中重写时，获取或设置执行 DbBatch 对象时所在的 DbTransaction。
Timeout	获取或设置 (等待时间（以秒为单位）) ，然后终止尝试执行批处理并生成错误。
Transaction	获取或设置将在其中执行此 DbBatch 对象的 DbTransaction。

方法

Cancel()	尝试取消 的执行 DbBatch。
CreateBatchCommand()	创建 DbBatchCommand 对象的新实例。
CreateDbBatchCommand()	在派生类中重写时，创建 DbBatchCommand 对象的新实例。
Dispose()	执行与释放或重置非托管资源关联的应用程序定义的任务。
DisposeAsync()	异步 diposes 批处理对象。
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)

配置如何执行从异步可处置项返回的任务的等待。