DbBatch クラス

定義

名前空間:
System.Data.Common
アセンブリ:
System.Data.Common.dll
ソース:
DbBatch.cs
ソース:
DbBatch.cs
ソース:
DbBatch.cs
ソース:
DbBatch.cs
ソース:
DbBatch.cs

1 回のラウンド トリップでデータ ソースに対して実行できるコマンドのバッチを表します。 コマンド バッチを表すデータベース固有のクラスの基本クラスを提供します。

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()

アンマネージド リソースの解放、解放、またはリセットに関連付けられているアプリケーション定義のタスクを実行します。
DisposeAsync()

バッチ オブジェクトを非同期的に破棄します。
Equals(Object)

指定したオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
ExecuteDbDataReader(CommandBehavior)

派生クラスでオーバーライドされると、その接続に対してバッチを実行し、結果にアクセスするために使用できる DbDataReader を返します。
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

プロバイダーは、このメソッドを実装して、 ExecuteReader オーバーロードの既定以外の実装を提供する必要があります。

既定の実装では、同期 ExecuteReader() メソッドが呼び出され、完了したタスクが返され、呼び出し元のスレッドがブロックされます。 既定の実装では、既に取り消されたキャンセル トークンが渡された場合、取り消されたタスクが返されます。 ExecuteReader によってスローされた例外は、返されたタスク例外プロパティを介して伝達されます。

このメソッドは、早期に取り消す操作を要求するために使用できるキャンセル トークンを受け入れます。 実装では、この要求は無視される場合があります。
ExecuteNonQuery()

接続オブジェクトに対してバッチを実行し、すべてのバッチ コマンドで影響を受けた行の合計数を返します。
ExecuteNonQueryAsync(CancellationToken)

これは、 ExecuteNonQuery()の非同期バージョンです。 プロバイダーは、適切な実装でオーバーライドする必要があります。 キャンセル トークンは、必要に応じて無視できます。

既定の実装では、同期 ExecuteNonQuery() メソッドが呼び出され、完了したタスクが返され、呼び出し元のスレッドがブロックされます。 既定の実装では、既に取り消されたキャンセル トークンが渡された場合、取り消されたタスクが返されます。 ExecuteNonQuery()によってスローされた例外は、返された Task Exception プロパティを介して伝達されます。

返された Task が完了するまで、 DbCommand オブジェクトの他のメソッドとプロパティを呼び出さないでください。
ExecuteReader(CommandBehavior)

接続に対してバッチを実行し、結果へのアクセスに使用できる DbDataReader を返します。
ExecuteReaderAsync(CancellationToken)

接続に対してバッチを実行し、結果にアクセスするために使用できるDbDataReaderを返す、ExecuteReaderの非同期バージョン。
ExecuteReaderAsync(CommandBehavior, CancellationToken)

接続に対してバッチを実行し、結果にアクセスするために使用できるDbDataReaderを返す、ExecuteReaderの非同期バージョン。
ExecuteScalar()

バッチを実行し、返された最初の結果セットの最初の行の最初の列を返します。 他のすべての列、行、結果セットは無視されます。
ExecuteScalarAsync(CancellationToken)

バッチを実行し、最初に返された結果セットの最初の行の最初の列を返す、 ExecuteScalar()の非同期バージョン。 他のすべての列、行、結果セットは無視されます。
GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
MemberwiseClone()

現在の Objectの簡易コピーを作成します。

(継承元 Object)
Prepare()

準備済み (またはコンパイル済み) バージョンのバッチ、またはその各コマンドをデータ ソースに作成します。
PrepareAsync(CancellationToken)

データ ソース上に、準備済み (またはコンパイル済み) バージョンのバッチまたはその各コマンドを非同期に作成します。
ToString()

現在のオブジェクトを表す文字列を返します。

(継承元 Object)

拡張メソッド

名前 説明
ConfigureAwait(IAsyncDisposable, Boolean)

非同期破棄から返されるタスクの待機を実行する方法を構成します。

適用対象