DbBatch クラス

リファレンス

定義

名前空間:: System.Data.Common

アセンブリ:: System.Data.Common.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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	この DbBatch オブジェクトが実行される DbTransaction を取得または設定します。

メソッド

Cancel()	の実行 DbBatchを取り消そうとします。
CreateBatchCommand()	DbBatchCommand オブジェクトの新しいインスタンスを作成します。
CreateDbBatchCommand()	派生クラス内でオーバーライドされた場合、DbBatchCommand オブジェクトの新しいインスタンスを作成します。
Dispose()	アンマネージリソースの解放またはリセットに関連付けられているアプリケーション定義のタスクを実行します。
DisposeAsync()	バッチオブジェクトを非同期的に dipose します。
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
ExecuteDbDataReader(CommandBehavior)	派生クラスでオーバーライドされると、その接続に対してバッチを実行し DbDataReader 、結果へのアクセスに使用できるを返します。
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	プロバイダーは、ExecuteReader のオーバーロードに既定以外の実装を提供するには、このメソッドを実装する必要があります。既定の実装は ExecuteReader() 同期メソッドを呼び出し、完了したタスクを返します。呼び出し元のスレッドはブロックされます。既定の実装は、既に取り消されたキャンセルトークンを渡した場合、取り消されたタスクを返します。 ExecuteReader によってスローされる例外は、返されたタスクの Exception プロパティを介して通信されます。このメソッドは、早期に操作をキャンセルすることを要求するために使用できるキャンセルトークンを受け取ります。実装は、この要求を無視する場合があります。
ExecuteNonQuery()	その接続オブジェクトに対してバッチを実行し、すべてのバッチコマンドで影響を受けた行の合計数を返します。
ExecuteNonQueryAsync(CancellationToken)	これは ExecuteNonQuery() の非同期バージョンです。プロバイダーは、適切な実装でオーバーライドする必要があります。オプションで、キャンセルトークンを無視できます。既定の実装は ExecuteNonQuery() 同期メソッドを呼び出し、完了したタスクを返します。呼び出し元のスレッドはブロックされます。既定の実装は、既に取り消されたキャンセルトークンを渡した場合、取り消されたタスクを返します。 ExecuteNonQuery() によってスローされる例外は、返されたタスクの Exception プロパティを介して通信されます。返されたタスクが完了するまで `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)

非同期の破棄可能から返されるタスク上での待機がどのように実行されるかを構成します。

適用対象