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供應商的文件。

建構函式

名稱	Description
DbBatch()	初始化 DbBatch 類別的新執行個體。

屬性

名稱	Description
BatchCommands	取得物品集合 DbBatchCommand 。
Connection	得到或設定 由 DbConnection 所使用 DbBatch。
DbBatchCommands	當在派生類別中覆寫時，會得到物件集合 DbBatchCommand 。
DbConnection	當在導出類別中覆寫時，會得到或設定 DbConnection 此類別所 DbBatch使用的。
DbTransaction	當在衍生類別中被覆寫時，會取得或設定 DbTransaction 該 DbBatch 物件執行的 。
Timeout	在終止執行批次並產生錯誤前，取得或設定等待時間（以秒為單位）。
Transaction	取得或設定該DbTransaction物件執行的內部。DbBatch

方法

名稱	Description
Cancel()	嘗試取消 DbBatch執行 。
CreateBatchCommand()	建立一個新的物件實例 DbBatchCommand 。
CreateDbBatchCommand()	當在衍生類別中覆寫時，會建立一個新的物件實例 DbBatchCommand 。
Dispose()	執行與釋放、釋放或重設非受控資源相關聯的應用程式定義工作。
DisposeAsync()	非同步丟棄批次物件。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
ExecuteDbDataReader(CommandBehavior)	當在衍生類別中覆寫時，會對其連線執行批次，回傳可用來存取結果的 a DbDataReader 。
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	提供者應實作此方法，以提供非預設的超載實 ExecuteReader 作。 預設實作會呼叫同步 ExecuteReader() 方法並回傳已完成的任務，阻擋呼叫執行緒。 預設實作若傳遞已取消的取消標記，會回傳已取消的任務。 ExecuteReader 拋出的異常會透過回傳的任務異常屬性來傳達。 此方法接受一個取消標記，可用來請求提前取消操作。 實施單位可能會忽略此請求。
ExecuteNonQuery()	會對其連接物件執行批次，並回傳所有批次指令中受影響的總列數。
ExecuteNonQueryAsync(CancellationToken)	這是非同步版本的 ExecuteNonQuery()。 提供者應該透過適當的實作來覆蓋。 取消標記可選擇性地忽略。 預設實作會呼叫同步 ExecuteNonQuery() 方法並回傳已完成的任務，阻擋呼叫執行緒。 預設實作若傳遞已取消的取消標記，會回傳已取消的任務。 所 ExecuteNonQuery() 拋出的異常會透過回傳的 Task Exception 屬性來傳達。 在回傳任務完成前，不要呼叫物件的其他 DbCommand 方法和屬性。
ExecuteReader(CommandBehavior)	會對其連線執行批次，回傳 DbDataReader 一個可用來存取結果的 a。
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)

擴充方法

名稱	Description
ConfigureAwait(IAsyncDisposable, Boolean)	設定如何執行從異步可處置專案傳回的工作等候。