DbBatch 類別

定義

命名空間:

System.Data.Common

組件:

System.Data.Common.dll

表示可以在單一往返中針對資料來源執行的命令批次。 提供代表命令批次之資料庫特定類別的基類。

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	取得或設定 DbTransaction，此 DbBatch 物件會在其中執行。

方法

Cancel()	嘗試取消 的執行 DbBatch 。
CreateBatchCommand()	建立 DbBatchCommand 物件的新執行個體。
CreateDbBatchCommand()	當覆寫衍生類別時，建立新的 DbBatchCommand 物件執行個體。
Dispose()	執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。
DisposeAsync()	以非同步方式將批次物件下降。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
ExecuteDbDataReader(CommandBehavior)	在衍生類別中覆寫時，針對其連線執行批次，傳回 DbDataReader 可用來存取結果的 。
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	提供者應該實作這個方法，以提供 ExecuteReader 多載的非預設實作。 預設實作會叫用同步ExecuteReader()方法，並傳回完成的工作，封鎖呼叫的執行緒。 如果傳遞一個已經被取消的取消語彙基元，預設實作會傳回已取消的工作。 ExecuteReader 擲回的例外狀況會透過傳回的 Task Exception 屬性來傳送。 這個方法會接受可以用來要求提早取消作業的取消語彙基元。 實作可以忽略這項要求。
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。