SqlCommand.ExecuteXmlReaderAsync Metoda

Definicja

Przestrzeń nazw:

Microsoft.Data.SqlClient

Zestaw:

Microsoft.Data.SqlClient.dll

Pakiet:

Microsoft.Data.SqlClient v5.2.0

Przeciążenia

ExecuteXmlReaderAsync()	Asynchroniczna wersja elementu ExecuteXmlReader() , która wysyła CommandText element do obiektu Connection i tworzy XmlReader obiekt . Wyjątki będą zgłaszane za pośrednictwem zwróconego obiektu Task.
ExecuteXmlReaderAsync(CancellationToken)	Asynchroniczna wersja elementu ExecuteXmlReader() , która wysyła CommandText element do obiektu Connection i tworzy XmlReader obiekt . 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 Task.

ExecuteXmlReaderAsync()

Asynchroniczna wersja elementu ExecuteXmlReader() , która wysyła CommandText element do obiektu Connection i tworzy XmlReader obiekt .

Wyjątki będą zgłaszane za pośrednictwem zwróconego obiektu 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)

Zwraca

Task<XmlReader>

Zadanie reprezentujące operację asynchroniczną.

Wyjątki

InvalidCastException

Użyto SqlDbType wartości innej 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 wartości innej niż Char, NChar, NVarChar, VarChar lub Xml , gdy Value ustawiono wartość TextReader .

-lub-

Element SqlDbType inny niż Xml był używany, gdy Value został ustawiony na XmlReader wartość .

InvalidOperationException

Wywołanie ExecuteScalarAsync(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-

Podczas operacji przesyłania strumieniowego wystąpiło przekroczenie limitu czasu. 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

Klasa XmlReader zwrócona przez tę metodę nie obsługuje operacji asynchronicznych. Aby uzyskać więcej informacji na temat programowania asynchronicznego w programie .NET Framework Data Provider for SQL Server, zobacz Asynchronous Programming (Programowanie asynchroniczne).

Uwaga

W przypadku długotrwałych zapytań na serwerze rozważ użycie ExecuteXmlReader 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 .

ExecuteXmlReaderAsync(CancellationToken)

Asynchroniczna wersja elementu ExecuteXmlReader() , która wysyła CommandText element do obiektu Connection i tworzy XmlReader obiekt .

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 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)

Parametry

cancellationToken

CancellationToken

Instrukcja anulowania.

Zwraca

Task<XmlReader>

Zadanie reprezentujące operację asynchroniczną.

Wyjątki

InvalidCastException

Użyto SqlDbType wartości innej 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 wartości innej niż Char, NChar, NVarChar, VarChar lub Xml , gdy Value ustawiono wartość TextReader .

-lub-

Element SqlDbType inny niż Xml był używany, gdy Value został ustawiony na XmlReader wartość .

InvalidOperationException

Wywołanie ExecuteScalarAsync(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-

Podczas operacji przesyłania strumieniowego wystąpiło przekroczenie limitu czasu. 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

Klasa XmlReader zwrócona przez tę metodę nie obsługuje operacji asynchronicznych. Aby uzyskać więcej informacji na temat programowania asynchronicznego w programie .NET Framework Data Provider for SQL Server, zobacz Asynchronous Programming (Programowanie asynchroniczne).