SqlConnection.OpenAsync(CancellationToken) メソッド

定義

名前空間:

Microsoft.Data.SqlClient

アセンブリ:

Microsoft.Data.SqlClient.dll

パッケージ:

Microsoft.Data.SqlClient v5.2.0

ConnectionString で指定したプロパティ設定を使用してデータベース接続を開く Open() の非同期バージョン。 キャンセル トークンを使用すると、接続タイムアウトが経過する前に操作を破棄することを要求できます。 例外は、返されたタスクによって伝達されます。 接続が成功せずに接続タイムアウトの時間が経過した場合、返されるタスクは例外での失敗としてマークされます。 実装は、プール済みの接続でもプールされていない接続でも、呼び出し元のスレッドをブロックすることなくタスクを返します。

public:
 override System::Threading::Tasks::Task ^ OpenAsync(System::Threading::CancellationToken cancellationToken);

public override System.Threading.Tasks.Task OpenAsync (System.Threading.CancellationToken cancellationToken);

override this.OpenAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overrides Function OpenAsync (cancellationToken As CancellationToken) As Task

パラメーター

cancellationToken

CancellationToken

取り消し命令。

戻り値

Task

非同期操作を表すタスク。

例外

InvalidOperationException

タスクの完了前に、同じインスタンスに対して OpenAsync(CancellationToken) を複数回呼び出しています。

接続タイムアウトが経過する前に、接続プールから接続を使用できませんでした。

SqlException

接続を開くときに発生した SQL Server によって返されるすべてのエラー。

注釈

を呼び出したOpenAsyncState後、返Connectingされる Task が完了するまで を返す必要があります。 その後、接続が成功した場合は、 State を返す Open必要があります。 接続に失敗した場合は、 State を返す Closed必要があります。

の Close 呼び出しでは、対応する OpenAsync 呼び出しを取り消すか閉じようとします。

SQL Serverの.NET Framework データ プロバイダーでの非同期プログラミングの詳細については、「非同期プログラミング」を参照してください。