DbBatch 類別

定義

命名空間:

System.Data.Common

組件:

System.Data.Common.dll

來源:

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)

設定如何執行從異步可處置專案傳回的工作等候。