DbBatch 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
表示可在一次往返中针对数据源执行的一批命令。 为表示命令批处理的数据库特定类提供基类。
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
- 继承
-
DbBatch
- 实现
注解
批处理执行的精确语义因 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() 引发的异常将通过任务异常属性传递。 在返回的任务完成前,不要调用 |
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) |
配置如何执行从异步可处置项返回的任务的等待。 |
适用于
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈