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 |
取得或設定 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() 擲回的例外狀況會透過傳回的工作例外狀況屬性來傳送。 在傳回的工作完成之前,不叫用 |
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。 |
適用於
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應