SqlCommand.ExecuteXmlReaderAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
この SqlCommand で記述されている Transact-SQL ステートメントまたはストアド プロシージャの非同期実行を開始し、結果を XmlReader オブジェクトとして返します。
オーバーロード
| 名前 | 説明 |
|---|---|
| ExecuteXmlReaderAsync() |
ExecuteXmlReader()の非同期バージョン。CommandTextをConnectionに送信し、XmlReader オブジェクトをビルドします。 例外は、返された Task オブジェクトを介して報告されます。 |
| ExecuteXmlReaderAsync(CancellationToken) |
ExecuteXmlReader()の非同期バージョン。CommandTextをConnectionに送信し、XmlReader オブジェクトをビルドします。 キャンセル トークンを使用して、コマンドのタイムアウトが経過する前に操作を破棄するように要求できます。 例外は、返された Task オブジェクトを介して報告されます。 |
ExecuteXmlReaderAsync()
ExecuteXmlReader()の非同期バージョン。CommandTextをConnectionに送信し、XmlReader オブジェクトをビルドします。
例外は、返された Task オブジェクトを介して報告されます。
public:
System::Threading::Tasks::Task<System::Xml::XmlReader ^> ^ ExecuteXmlReaderAsync();public System.Threading.Tasks.Task<System.Xml.XmlReader> ExecuteXmlReaderAsync();member this.ExecuteXmlReaderAsync : unit -> System.Threading.Tasks.Task<System.Xml.XmlReader>Public Function ExecuteXmlReaderAsync () As Task(Of XmlReader)返品
非同期操作を表すタスク。
例外
SqlDbTypeがに設定されたときに、Binary または Value 以外のStreamが使用されました。 ストリーミングの詳細については、「 SqlClient ストリーミング のサポート」を参照してください。
-または-
SqlDbTypeがに設定されたときに、Char、NChar、NVarChar、VarCharValueのTextReaderが使用されました。
-または-
タスクが完了する前に、同じインスタンスに対して ExecuteScalarAsync(CancellationToken) を複数回呼び出します。
-または-
SqlConnectionストリーミング操作中に閉じたり削除されたりします。 ストリーミングの詳細については、「 SqlClient ストリーミング のサポート」を参照してください。
-または-
Context Connection=trueは、接続文字列で指定します。
SQL Serverコマンド テキストの実行中にエラーが返されました。
-または-
ストリーミング操作中にタイムアウトが発生しました。 ストリーミングの詳細については、「 SqlClient ストリーミング のサポート」を参照してください。
ストリーミング操作中に、 Stream、 XmlReader 、または TextReader オブジェクトでエラーが発生しました。 ストリーミングの詳細については、「 SqlClient ストリーミング のサポート」を参照してください。
ストリーミング操作中に、 Stream、 XmlReader 、または TextReader オブジェクトが閉じられました。 ストリーミングの詳細については、「 SqlClient ストリーミング のサポート」を参照してください。
注釈
このメソッドによって返される XmlReader は、非同期操作をサポートしていません。
SQL Serverの.NET Framework Data Providerでの非同期プログラミングの詳細については、「Asynchronous Programming」を参照してください。
このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。 格納されている例外については、 ExecuteXmlReader()によってスローされる例外を参照してください。
こちらもご覧ください
適用対象
ExecuteXmlReaderAsync(CancellationToken)
ExecuteXmlReader()の非同期バージョン。CommandTextをConnectionに送信し、XmlReader オブジェクトをビルドします。
キャンセル トークンを使用して、コマンドのタイムアウトが経過する前に操作を破棄するように要求できます。 例外は、返された Task オブジェクトを介して報告されます。
public:
System::Threading::Tasks::Task<System::Xml::XmlReader ^> ^ ExecuteXmlReaderAsync(System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Xml.XmlReader> ExecuteXmlReaderAsync(System.Threading.CancellationToken cancellationToken);member this.ExecuteXmlReaderAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Xml.XmlReader>Public Function ExecuteXmlReaderAsync (cancellationToken As CancellationToken) As Task(Of XmlReader)パラメーター
- cancellationToken
- CancellationToken
取り消し命令。
返品
非同期操作を表すタスク。
例外
SqlDbTypeがに設定されたときに、Binary または Value 以外のStreamが使用されました。 ストリーミングの詳細については、「 SqlClient ストリーミング のサポート」を参照してください。
-または-
SqlDbTypeがに設定されたときに、Char、NChar、NVarChar、VarCharValueのTextReaderが使用されました。
-または-
タスクが完了する前に、同じインスタンスに対して ExecuteScalarAsync(CancellationToken) を複数回呼び出します。
-または-
SqlConnectionストリーミング操作中に閉じたり削除されたりします。 ストリーミングの詳細については、「 SqlClient ストリーミング のサポート」を参照してください。
-または-
Context Connection=trueは、接続文字列で指定します。
SQL Serverコマンド テキストの実行中にエラーが返されました。
-または-
ストリーミング操作中にタイムアウトが発生しました。 ストリーミングの詳細については、「 SqlClient ストリーミング のサポート」を参照してください。
ストリーミング操作中に、 Stream、 XmlReader 、または TextReader オブジェクトでエラーが発生しました。 ストリーミングの詳細については、「 SqlClient ストリーミング のサポート」を参照してください。
ストリーミング操作中に、 Stream、 XmlReader 、または TextReader オブジェクトが閉じられました。 ストリーミングの詳細については、「 SqlClient ストリーミング のサポート」を参照してください。
キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。
注釈
このメソッドによって返される XmlReader は、非同期操作をサポートしていません。
SQL Serverの.NET Framework Data Providerでの非同期プログラミングの詳細については、「Asynchronous Programming」を参照してください。
このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。 格納されている例外については、 ExecuteXmlReader()によってスローされる例外を参照してください。