SqlCommand.ExecuteReaderAsync Metoda

Definicja

Przestrzeń nazw:

System.Data.SqlClient

Zestaw:

System.Data.dll

Inicjuje asynchroniczne wykonywanie instrukcji Transact-SQL lub procedury składowanej opisanej przez ten element SqlCommand.

W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.

Przeciążenia

Nazwisko	Opis
ExecuteReaderAsync()	Asynchroniczna wersja ExecuteReader()elementu , która wysyła CommandText element do Connection elementu i tworzy element SqlDataReader. Wyjątki będą zgłaszane za pośrednictwem zwróconego obiektu Zadania. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
ExecuteReaderAsync(CommandBehavior)	Asynchroniczna wersja ExecuteReader(CommandBehavior)elementu , która wysyła CommandText element do Connectionelementu i tworzy element SqlDataReader. Wyjątki będą zgłaszane za pośrednictwem zwróconego obiektu Zadania. <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>
ExecuteReaderAsync(CancellationToken)	Asynchroniczna wersja ExecuteReader()elementu , która wysyła CommandText element do Connection elementu i tworzy element SqlDataReader. 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>
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Asynchroniczna wersja elementu ExecuteReader(CommandBehavior), która wysyła CommandText element do Connectionelementu i tworzy element SqlDataReader 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>

Uwagi

Aby uzyskać więcej informacji na temat programowania asynchronicznego w Dostawca danych .NET Framework dla SQL Server, zobacz Asynchronous Programming.

ExecuteReaderAsync()

Asynchroniczna wersja ExecuteReader()elementu , która wysyła CommandText element do Connection elementu i tworzy element SqlDataReader. Wyjątki będą zgłaszane za pośrednictwem zwróconego obiektu Zadania.

W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.

public:
 System::Threading::Tasks::Task<System::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync();

public System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader> ExecuteReaderAsync();

override this.ExecuteReaderAsync : unit -> System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader>

Public Function ExecuteReaderAsync () As Task(Of SqlDataReader)

Zwraca

Task<SqlDataReader>

Zadanie reprezentujące operację asynchroniczną.

Wyjątki

InvalidCastException

Użyto SqlDbType innej wartości niż Binary lub VarBinary , gdy Value ustawiono wartość Stream. Aby uzyskać więcej informacji na temat przesyłania strumieniowego, zobacz Obsługa przesyłania strumieniowego SqlClient.

— lub —

Użyto SqlDbType innego niż Char, NChar, NVarChar, VarChar lub Xml , gdy Value ustawiono wartość TextReader.

— lub —

Użyto SqlDbType innej wartości niż Xml , gdy Value ustawiono wartość XmlReader.

ArgumentException

Nieprawidłowa CommandBehavior wartość.

InvalidOperationException

Wywołanie ExecuteReaderAsync() więcej niż raz dla tego samego wystąpienia przed ukończeniem zadania.

— lub —

Zamknięty SqlConnection lub porzucony podczas operacji przesyłania strumieniowego. Aby uzyskać więcej informacji na temat przesyłania strumieniowego, zobacz Obsługa przesyłania strumieniowego SqlClient.

— lub —

Context Connection=true jest określony w parametry połączenia.

SqlException

SQL Server zwrócił błąd podczas wykonywania tekstu polecenia.

— lub —

Wystąpił limit czasu podczas operacji przesyłania strumieniowego. Aby uzyskać więcej informacji na temat przesyłania strumieniowego, zobacz Obsługa przesyłania strumieniowego SqlClient.

IOException

Wystąpił błąd w StreamXmlReader obiekcie lub TextReader podczas operacji przesyłania strumieniowego. Aby uzyskać więcej informacji na temat przesyłania strumieniowego, zobacz Obsługa przesyłania strumieniowego SqlClient.

ObjectDisposedException

Stream Obiekt XmlReaderlub TextReader został zamknięty podczas operacji przesyłania strumieniowego. Aby uzyskać więcej informacji na temat przesyłania strumieniowego, zobacz Obsługa przesyłania strumieniowego SqlClient.

Uwagi

Aby uzyskać więcej informacji na temat programowania asynchronicznego w Dostawca danych .NET Framework dla SQL Server, zobacz Asynchronous Programming.

Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez program ExecuteReader().

Zobacz też

• Omówienie ADO.NET

ExecuteReaderAsync(CommandBehavior)

Asynchroniczna wersja ExecuteReader(CommandBehavior)elementu , która wysyła CommandText element do Connectionelementu i tworzy element SqlDataReader. Wyjątki będą zgłaszane za pośrednictwem zwróconego obiektu Zadania.

      <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::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync(System::Data::CommandBehavior behavior);

public System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader> ExecuteReaderAsync(System.Data.CommandBehavior behavior);

override this.ExecuteReaderAsync : System.Data.CommandBehavior -> System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader>

Public Function ExecuteReaderAsync (behavior As CommandBehavior) As Task(Of SqlDataReader)

Parametry

behavior

CommandBehavior

Opcje wykonywania instrukcji i pobierania danych. Gdy jest ustawiona wartość Default, ReadAsync(CancellationToken) odczytuje cały wiersz przed zwróceniem ukończonego zadania.

Zwraca

Task<SqlDataReader>

Zadanie reprezentujące operację asynchroniczną.

Wyjątki

InvalidCastException

Użyto SqlDbType innej wartości niż Binary lub VarBinary , gdy Value ustawiono wartość Stream. Aby uzyskać więcej informacji na temat przesyłania strumieniowego, zobacz Obsługa przesyłania strumieniowego SqlClient.

— lub —

Użyto SqlDbType innego niż Char, NChar, NVarChar, VarChar lub Xml , gdy Value ustawiono wartość TextReader.

— lub —

Użyto SqlDbType innej wartości niż Xml , gdy Value ustawiono wartość XmlReader.

ArgumentException

Nieprawidłowa CommandBehavior wartość.

InvalidOperationException

Wywołanie ExecuteReaderAsync(CommandBehavior) więcej niż raz dla tego samego wystąpienia przed ukończeniem zadania.

— lub —

Zamknięty SqlConnection lub porzucony podczas operacji przesyłania strumieniowego. Aby uzyskać więcej informacji na temat przesyłania strumieniowego, zobacz Obsługa przesyłania strumieniowego SqlClient.

— lub —

Context Connection=true jest określony w parametry połączenia.

SqlException

SQL Server zwrócił błąd podczas wykonywania tekstu polecenia.

— lub —

Wystąpił limit czasu podczas operacji przesyłania strumieniowego. Aby uzyskać więcej informacji na temat przesyłania strumieniowego, zobacz Obsługa przesyłania strumieniowego SqlClient.

IOException

Wystąpił błąd w StreamXmlReader obiekcie lub TextReader podczas operacji przesyłania strumieniowego. Aby uzyskać więcej informacji na temat przesyłania strumieniowego, zobacz Obsługa przesyłania strumieniowego SqlClient.

ObjectDisposedException

Stream Obiekt XmlReaderlub TextReader został zamknięty podczas operacji przesyłania strumieniowego. Aby uzyskać więcej informacji na temat przesyłania strumieniowego, zobacz Obsługa przesyłania strumieniowego SqlClient.

Uwagi

Aby uzyskać więcej informacji na temat programowania asynchronicznego w Dostawca danych .NET Framework dla SQL Server, zobacz Asynchronous Programming.

Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez program ExecuteReader(CommandBehavior).

Zobacz też

• Omówienie ADO.NET

ExecuteReaderAsync(CancellationToken)

Asynchroniczna wersja ExecuteReader()elementu , która wysyła CommandText element do Connection elementu i tworzy element SqlDataReader.

      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::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync(System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader> ExecuteReaderAsync(System.Threading.CancellationToken cancellationToken);

override this.ExecuteReaderAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader>

Public Function ExecuteReaderAsync (cancellationToken As CancellationToken) As Task(Of SqlDataReader)

Parametry

cancellationToken

CancellationToken

Instrukcja anulowania.

Zwraca

Task<SqlDataReader>

Zadanie reprezentujące operację asynchroniczną.

Wyjątki

InvalidCastException

Użyto SqlDbType innej wartości niż Binary lub VarBinary , gdy Value ustawiono wartość Stream. Aby uzyskać więcej informacji na temat przesyłania strumieniowego, zobacz Obsługa przesyłania strumieniowego SqlClient.

— lub —

Użyto SqlDbType innego niż Char, NChar, NVarChar, VarChar lub Xml , gdy Value ustawiono wartość TextReader.

— lub —

Użyto SqlDbType innej wartości niż Xml , gdy Value ustawiono wartość XmlReader.

ArgumentException

Nieprawidłowa CommandBehavior wartość.

InvalidOperationException

Wywołanie ExecuteReaderAsync(CommandBehavior, CancellationToken) więcej niż raz dla tego samego wystąpienia przed ukończeniem zadania.

— lub —

Zamknięty SqlConnection lub porzucony podczas operacji przesyłania strumieniowego. Aby uzyskać więcej informacji na temat przesyłania strumieniowego, zobacz Obsługa przesyłania strumieniowego SqlClient.

— lub —

Context Connection=true jest określony w parametry połączenia.

SqlException

SQL Server zwrócił błąd podczas wykonywania tekstu polecenia.

— lub —

Wystąpił limit czasu podczas operacji przesyłania strumieniowego. Aby uzyskać więcej informacji na temat przesyłania strumieniowego, zobacz Obsługa przesyłania strumieniowego SqlClient.

IOException

Wystąpił błąd w StreamXmlReader obiekcie lub TextReader podczas operacji przesyłania strumieniowego. Aby uzyskać więcej informacji na temat przesyłania strumieniowego, zobacz Obsługa przesyłania strumieniowego SqlClient.

ObjectDisposedException

Stream Obiekt XmlReaderlub TextReader został zamknięty podczas operacji przesyłania strumieniowego. Aby uzyskać więcej informacji na temat przesyłania strumieniowego, zobacz Obsługa przesyłania strumieniowego SqlClient.

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

Uwagi

Aby uzyskać więcej informacji na temat programowania asynchronicznego w Dostawca danych .NET Framework dla SQL Server, zobacz Asynchronous Programming.

Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez program ExecuteReader().

Zobacz też

• Omówienie ADO.NET

ExecuteReaderAsync(CommandBehavior, CancellationToken)

Asynchroniczna wersja elementu ExecuteReader(CommandBehavior), która wysyła CommandText element do Connectionelementu i tworzy element SqlDataReader

      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::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync(System::Data::CommandBehavior behavior, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader> ExecuteReaderAsync(System.Data.CommandBehavior behavior, System.Threading.CancellationToken cancellationToken);

override this.ExecuteReaderAsync : System.Data.CommandBehavior * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader>

Public Function ExecuteReaderAsync (behavior As CommandBehavior, cancellationToken As CancellationToken) As Task(Of SqlDataReader)

Parametry

behavior

CommandBehavior

Opcje wykonywania instrukcji i pobierania danych. Gdy jest ustawiona wartość Default, ReadAsync(CancellationToken) odczytuje cały wiersz przed zwróceniem ukończonego zadania.

cancellationToken

CancellationToken

Instrukcja anulowania.

Zwraca

Task<SqlDataReader>

Zadanie reprezentujące operację asynchroniczną.

Wyjątki

InvalidCastException

Użyto SqlDbType innej wartości niż Binary lub VarBinary , gdy Value ustawiono wartość Stream. Aby uzyskać więcej informacji na temat przesyłania strumieniowego, zobacz Obsługa przesyłania strumieniowego SqlClient.

— lub —

Użyto SqlDbType innego niż Char, NChar, NVarChar, VarChar lub Xml , gdy Value ustawiono wartość TextReader.

— lub —

Użyto SqlDbType innej wartości niż Xml , gdy Value ustawiono wartość XmlReader.

ArgumentException

Nieprawidłowa CommandBehavior wartość.

InvalidOperationException

Wywołanie ExecuteReaderAsync(CommandBehavior, CancellationToken) więcej niż raz dla tego samego wystąpienia przed ukończeniem zadania.

— lub —

Zamknięty SqlConnection lub porzucony podczas operacji przesyłania strumieniowego. Aby uzyskać więcej informacji na temat przesyłania strumieniowego, zobacz Obsługa przesyłania strumieniowego SqlClient.

— lub —

Context Connection=true jest określony w parametry połączenia.

SqlException

SQL Server zwrócił błąd podczas wykonywania tekstu polecenia.

— lub —

Wystąpił limit czasu podczas operacji przesyłania strumieniowego. Aby uzyskać więcej informacji na temat przesyłania strumieniowego, zobacz Obsługa przesyłania strumieniowego SqlClient.

IOException

Wystąpił błąd w StreamXmlReader obiekcie lub TextReader podczas operacji przesyłania strumieniowego. Aby uzyskać więcej informacji na temat przesyłania strumieniowego, zobacz Obsługa przesyłania strumieniowego SqlClient.

ObjectDisposedException

Stream Obiekt XmlReaderlub TextReader został zamknięty podczas operacji przesyłania strumieniowego. Aby uzyskać więcej informacji na temat przesyłania strumieniowego, zobacz Obsługa przesyłania strumieniowego SqlClient.

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

Uwagi

Aby uzyskać więcej informacji na temat programowania asynchronicznego w Dostawca danych .NET Framework dla SQL Server, zobacz Asynchronous Programming.

Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez program ExecuteReader(CommandBehavior).

Zobacz też

• Omówienie ADO.NET