Language

SqlCommand.ExecuteXmlReaderAsync メソッド

定義

名前空間:
System.Data.SqlClient
アセンブリ:
System.Data.SqlClient.dll
アセンブリ:
System.Data.dll

この SqlCommand で記述されている Transact-SQL ステートメントまたはストアド プロシージャの非同期実行を開始し、結果を XmlReader オブジェクトとして返します。

新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。

オーバーロード

Name 説明
ExecuteXmlReaderAsync()

ExecuteXmlReader()の非同期バージョン。CommandTextをConnectionに送信し、XmlReader オブジェクトをビルドします。

例外は、返された Task オブジェクトを介して報告されます。

新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。
ExecuteXmlReaderAsync(CancellationToken)

ExecuteXmlReader()の非同期バージョン。CommandTextをConnectionに送信し、XmlReader オブジェクトをビルドします。

      The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object.

      <p>For new development, use <a href="/sql/connect/ado-net/introduction-microsoft-data-sqlclient-namespace">Microsoft.Data.SqlClient</a>. This page documents System.Data.SqlClient.</p>

ExecuteXmlReaderAsync()

ソース:
System.Data.SqlClient.notsupported.cs

ExecuteXmlReader()の非同期バージョン。CommandTextをConnectionに送信し、XmlReader オブジェクトをビルドします。

例外は、返された Task オブジェクトを介して報告されます。

新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。

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)

戻り値

Task<XmlReader>

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

例外

InvalidCastException

SqlDbTypeがに設定されたときに、Binary または Value 以外のStreamが使用されました。 ストリーミングの詳細については、「 SqlClient ストリーミング のサポート」を参照してください。

-又は-

SqlDbTypeがに設定されたときに、Char、NChar、NVarChar、VarCharValueのTextReaderが使用されました。

-又は-

SqlDbType 以外のは、Valueが XmlReader に設定されたときに使用されました。

InvalidOperationException

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

-又は-

SqlConnectionストリーミング操作中に閉じたり削除されたりします。 ストリーミングの詳細については、「 SqlClient ストリーミング のサポート」を参照してください。

-又は-

Context Connection=trueは、接続文字列で指定します。

SqlException

SQL Serverコマンド テキストの実行中にエラーが返されました。

-又は-

ストリーミング操作中にタイムアウトが発生しました。 ストリーミングの詳細については、「 SqlClient ストリーミング のサポート」を参照してください。

IOException

ストリーミング操作中に、 Stream、 XmlReader 、または TextReader オブジェクトでエラーが発生しました。 ストリーミングの詳細については、「 SqlClient ストリーミング のサポート」を参照してください。

ObjectDisposedException

ストリーミング操作中に、 Stream、 XmlReader 、または TextReader オブジェクトが閉じられました。 ストリーミングの詳細については、「 SqlClient ストリーミング のサポート」を参照してください。

注釈

このメソッドによって返される XmlReader は、非同期操作をサポートしていません。

SQL Serverの.NET Framework Data Providerでの非同期プログラミングの詳細については、「Asynchronous Programming」を参照してください。

このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。 格納されている例外については、 ExecuteXmlReader()によってスローされる例外を参照してください。

関連項目

適用対象

ExecuteXmlReaderAsync(CancellationToken)

ソース:
System.Data.SqlClient.notsupported.cs

ExecuteXmlReader()の非同期バージョン。CommandTextをConnectionに送信し、XmlReader オブジェクトをビルドします。

      The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object.

      <p>For new development, use <a href="/sql/connect/ado-net/introduction-microsoft-data-sqlclient-namespace">Microsoft.Data.SqlClient</a>. This page documents System.Data.SqlClient.</p>

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

取り消し命令。

戻り値

Task<XmlReader>

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

例外

InvalidCastException

SqlDbTypeがに設定されたときに、Binary または Value 以外のStreamが使用されました。 ストリーミングの詳細については、「 SqlClient ストリーミング のサポート」を参照してください。

-又は-

SqlDbTypeがに設定されたときに、Char、NChar、NVarChar、VarCharValueのTextReaderが使用されました。

-又は-

SqlDbType 以外のは、Valueが XmlReader に設定されたときに使用されました。

InvalidOperationException

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

-又は-

SqlConnectionストリーミング操作中に閉じたり削除されたりします。 ストリーミングの詳細については、「 SqlClient ストリーミング のサポート」を参照してください。

-又は-

Context Connection=trueは、接続文字列で指定します。

SqlException

SQL Serverコマンド テキストの実行中にエラーが返されました。

-又は-

ストリーミング操作中にタイムアウトが発生しました。 ストリーミングの詳細については、「 SqlClient ストリーミング のサポート」を参照してください。

IOException

ストリーミング操作中に、 Stream、 XmlReader 、または TextReader オブジェクトでエラーが発生しました。 ストリーミングの詳細については、「 SqlClient ストリーミング のサポート」を参照してください。

ObjectDisposedException

ストリーミング操作中に、 Stream、 XmlReader 、または TextReader オブジェクトが閉じられました。 ストリーミングの詳細については、「 SqlClient ストリーミング のサポート」を参照してください。

OperationCanceledException

キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。

注釈

このメソッドによって返される XmlReader は、非同期操作をサポートしていません。

SQL Serverの.NET Framework Data Providerでの非同期プログラミングの詳細については、「Asynchronous Programming」を参照してください。

このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。 格納されている例外については、 ExecuteXmlReader()によってスローされる例外を参照してください。

関連項目

適用対象