SqlCommand.ExecuteReaderAsync Metoda

Definicja

Przestrzeń nazw:

Microsoft.Data.SqlClient

Zestaw:

Microsoft.Data.SqlClient.dll

Pakiet:

Microsoft.Data.SqlClient v5.2.0

Przeciążenia

ExecuteReaderAsync()	Asynchroniczna wersja elementu ExecuteReader() , która wysyła element CommandText do elementu Connection i tworzy element SqlDataReader . Wyjątki będą zgłaszane za pośrednictwem zwróconego obiektu Zadania.
ExecuteReaderAsync(CommandBehavior)	Asynchroniczna wersja elementu ExecuteReader(CommandBehavior) , która wysyła element CommandText do Connection elementu i tworzy element SqlDataReader . Wyjątki będą zgłaszane za pośrednictwem zwróconego obiektu Zadania.
ExecuteReaderAsync(CancellationToken)	Asynchroniczna wersja elementu ExecuteReader() , która wysyła element CommandText do elementu Connection i tworzy element SqlDataReader . Token anulowania może służyć do żądania, aby operacja została porzucona przed upływem limitu czasu polecenia. Wyjątki będą zgłaszane za pośrednictwem zwróconego obiektu Zadania.
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Asynchroniczna wersja elementu ExecuteReader(CommandBehavior) , która wysyła element CommandText do Connection elementu i tworzy SqlDataReader token anulowania, może służyć do żądania, aby operacja została porzucona przed upływem limitu czasu polecenia. Wyjątki będą zgłaszane za pośrednictwem zwróconego obiektu Zadania.

ExecuteReaderAsync()

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

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

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

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

Public Function ExecuteReaderAsync () As Task(Of SqlDataReader)

Zwraca

Task<SqlDataReader>

Zadanie reprezentujące operację asynchroniczną.

Wyjątki

InvalidCastException

Użyto SqlDbType innego elementu 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-

Inny SqlDbType niż Xml był używany, 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.

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

XmlReader Obiekt Stream lub 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 .NET Framework Data Provider for SQL Server, zobacz Asynchronous Programming (Programowanie asynchroniczne).

Uwaga

W przypadku długotrwałych zapytań na serwerze rozważ użycie ExecuteReader z powodu znanego problemu z anulowaniem zapytań za pośrednictwem tokenu anulowania. Należy również rozważyć anulowanie wykonywania przy użyciu Cancel metody .

ExecuteReaderAsync(CommandBehavior)

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

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

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

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

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

Parametry

behavior

CommandBehavior

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

Zwraca

Task<SqlDataReader>

Zadanie reprezentujące operację asynchroniczną.

Wyjątki

InvalidCastException

Użyto SqlDbType innego elementu 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-

Inny SqlDbType niż Xml był używany, 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.

-or- SqlConnection zamknięte lub porzucone podczas operacji przesyłania strumieniowego. Aby uzyskać więcej informacji na temat przesyłania strumieniowego, zobacz Obsługa przesyłania strumieniowego sqlClient.

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

XmlReader Obiekt Stream lub 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 .NET Framework Data Provider for SQL Server, zobacz Asynchronous Programming (Programowanie asynchroniczne).

ExecuteReaderAsync(CancellationToken)

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

Token anulowania może służyć do żądania, aby operacja została porzucona przed upływem limitu czasu polecenia. Wyjątki będą zgłaszane za pośrednictwem zwróconego obiektu Zadania.

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

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

override this.ExecuteReaderAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.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 innego elementu 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-

Inny SqlDbType niż Xml był używany, 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.

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

XmlReader Obiekt Stream lub 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 .NET Framework Data Provider for SQL Server, zobacz Asynchronous Programming (Programowanie asynchroniczne).

ExecuteReaderAsync(CommandBehavior, CancellationToken)

Asynchroniczna wersja elementu ExecuteReader(CommandBehavior) , która wysyła element CommandText do Connection elementu i tworzy SqlDataReader token anulowania, może służyć do żądania, aby operacja została porzucona przed upływem limitu czasu polecenia. Wyjątki będą zgłaszane za pośrednictwem zwróconego obiektu Zadania.

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

public System.Threading.Tasks.Task<Microsoft.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<Microsoft.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. Kiedy jest ustawiona wartośćDefault , ReadAsync(CancellationToken) odczytuje cały wiersz przed zwróceniem kompletnego zadania.

cancellationToken

CancellationToken

Instrukcja anulowania.

Zwraca

Task<SqlDataReader>

Zadanie reprezentujące operację asynchroniczną.

Wyjątki

InvalidCastException

Użyto SqlDbType innego elementu 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-

Inny SqlDbType niż Xml był używany, 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.

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

XmlReader Obiekt Stream lub 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 .NET Framework Data Provider for SQL Server, zobacz Asynchronous Programming (Programowanie asynchroniczne).