SqlCommand.ExecuteReaderAsync Methode

Definition

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Überlädt

ExecuteReaderAsync()	Eine asynchrone Version von ExecuteReader() , die an die ConnectionCommandText sendet und eine SqlDataReader erstellt. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.
ExecuteReaderAsync(CommandBehavior)	Eine asynchrone Version von ExecuteReader(CommandBehavior) , die an CommandText die Connection sendet und eine SqlDataReader erstellt. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.
ExecuteReaderAsync(CancellationToken)	Eine asynchrone Version von ExecuteReader() , die an die ConnectionCommandText sendet und eine SqlDataReader erstellt. Das Abbruchtoken kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Timeout des Befehls abläuft. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Eine asynchrone Version von ExecuteReader(CommandBehavior) , die an CommandTextConnection die sendet und ein SqlDataReader Abbruchtoken erstellt, kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Befehlstimeout abgelaufen ist. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.

ExecuteReaderAsync()

Eine asynchrone Version von ExecuteReader() , die an die ConnectionCommandText sendet und eine SqlDataReader erstellt. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.

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)

Gibt zurück

Task<SqlDataReader>

Eine Aufgabe, die den asynchronen Vorgang darstellt.

Ausnahmen

InvalidCastException

Ein SqlDbType anderes als Binary oder VarBinary wurde verwendet, wenn Value auf Stream festgelegt wurde. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).

- oder -

Ein SqlDbType anderes als Char, NChar, NVarChar, VarChar oder Xml wurde verwendet, wenn Value auf TextReader festgelegt wurde.

Oder

Ein SqlDbType anderer als Xml wurde verwendet, wenn Value auf XmlReader festgelegt wurde.

ArgumentException

Ein ungültiger CommandBehavior-Wert.

InvalidOperationException

ExecuteReaderAsync() wird vor dem Abschluss der Aufgabe mehrmals für dieselbe Instanz aufgerufen.

- oder -

Die SqlConnection wurde während eines Streamingvorgangs geschlossen oder getrennt. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).

SqlException

SQL Server hat beim Ausführen des Befehlstexts einen Fehler zurückgegeben.

- oder -

Bei einem Streamingvorgang ist ein Timeout aufgetreten. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).

IOException

Während eines Streamingvorgangs ist ein Fehler in einem Stream - XmlReader oder TextReader -Objekt aufgetreten. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).

ObjectDisposedException

Das Stream - XmlReader oder TextReader -Objekt wurde während eines Streamingvorgangs geschlossen. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).

Hinweise

Weitere Informationen zur asynchronen Programmierung im .NET Framework-Datenanbieter für SQL Server finden Sie unter Asynchrone Programmierung.

Hinweis

Für Abfragen mit langer Ausführungszeit auf dem Server sollten Sie aufgrund eines bekannten Problems beim Abbrechen von Abfragen über ein Abbruchtoken verwenden ExecuteReader . Erwägen Sie außerdem, die Ausführung mithilfe der Cancel -Methode abzubrechen.

ExecuteReaderAsync(CommandBehavior)

Eine asynchrone Version von ExecuteReader(CommandBehavior) , die an CommandText die Connection sendet und eine SqlDataReader erstellt. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.

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)

Parameter

behavior

CommandBehavior

Optionen zur Ausführung der Anweisung und zum Datenabruf. Wenn auf festgelegt istDefault liest ReadAsync(CancellationToken) die gesamte Zeile, bevor eine abgeschlossene Aufgabe zurückgegeben wird.

Gibt zurück

Task<SqlDataReader>

Eine Aufgabe, die den asynchronen Vorgang darstellt.

Ausnahmen

InvalidCastException

Ein SqlDbType anderes als Binary oder VarBinary wurde verwendet, wenn Value auf Stream festgelegt wurde. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).

- oder -

Ein SqlDbType anderes als Char, NChar, NVarChar, VarChar oder Xml wurde verwendet, wenn Value auf TextReader festgelegt wurde.

Oder

Ein SqlDbType anderer als Xml wurde verwendet, wenn Value auf XmlReader festgelegt wurde.

ArgumentException

Ein ungültiger CommandBehavior-Wert.

InvalidOperationException

ExecuteReaderAsync(CommandBehavior) wird vor dem Abschluss der Aufgabe mehrmals für dieselbe Instanz aufgerufen.

Oder: SqlConnection während eines Streamingvorgangs geschlossen oder gelöscht. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).

SqlException

SQL Server hat beim Ausführen des Befehlstexts einen Fehler zurückgegeben.

- oder -

Bei einem Streamingvorgang ist ein Timeout aufgetreten. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).

IOException

Während eines Streamingvorgangs ist ein Fehler in einem Stream - XmlReader oder TextReader -Objekt aufgetreten. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).

ObjectDisposedException

Das Stream - XmlReader oder TextReader -Objekt wurde während eines Streamingvorgangs geschlossen. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).

Hinweise

Weitere Informationen zur asynchronen Programmierung im .NET Framework-Datenanbieter für SQL Server finden Sie unter Asynchrone Programmierung.

ExecuteReaderAsync(CancellationToken)

Eine asynchrone Version von ExecuteReader() , die an die ConnectionCommandText sendet und eine SqlDataReader erstellt.

Das Abbruchtoken kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Timeout des Befehls abläuft. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.

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)

Parameter

cancellationToken

CancellationToken

Die Abbruchanweisung.

Gibt zurück

Task<SqlDataReader>

Eine Aufgabe, die den asynchronen Vorgang darstellt.

Ausnahmen

InvalidCastException

Ein SqlDbType anderes als Binary oder VarBinary wurde verwendet, wenn Value auf Stream festgelegt wurde. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).

- oder -

Ein SqlDbType anderes als Char, NChar, NVarChar, VarChar oder Xml wurde verwendet, wenn Value auf TextReader festgelegt wurde.

Oder

Ein SqlDbType anderer als Xml wurde verwendet, wenn Value auf XmlReader festgelegt wurde.

ArgumentException

Ein ungültiger CommandBehavior-Wert.

InvalidOperationException

ExecuteReaderAsync(CommandBehavior, CancellationToken) wird vor dem Abschluss der Aufgabe mehrmals für dieselbe Instanz aufgerufen.

- oder -

Die SqlConnection wurde während eines Streamingvorgangs geschlossen oder getrennt. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).

SqlException

SQL Server hat beim Ausführen des Befehlstexts einen Fehler zurückgegeben.

- oder -

Bei einem Streamingvorgang ist ein Timeout aufgetreten. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).

IOException

Während eines Streamingvorgangs ist ein Fehler in einem Stream - XmlReader oder TextReader -Objekt aufgetreten. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).

ObjectDisposedException

Das Stream - XmlReader oder TextReader -Objekt wurde während eines Streamingvorgangs geschlossen. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).

Hinweise

Weitere Informationen zur asynchronen Programmierung im .NET Framework-Datenanbieter für SQL Server finden Sie unter Asynchrone Programmierung.

ExecuteReaderAsync(CommandBehavior, CancellationToken)

Eine asynchrone Version von ExecuteReader(CommandBehavior) , die an CommandText die Connection sendet und ein SqlDataReader Abbruchtoken erstellt, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Befehlstimeout verstrichen ist. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.

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)

Parameter

behavior

CommandBehavior

Optionen zur Ausführung der Anweisung und zum Datenabruf. Wenn auf festgelegt istDefault liest ReadAsync(CancellationToken) die gesamte Zeile, bevor eine vollständige Aufgabe zurückgegeben wird.

cancellationToken

CancellationToken

Die Abbruchanweisung.

Gibt zurück

Task<SqlDataReader>

Eine Aufgabe, die den asynchronen Vorgang darstellt.

Ausnahmen

InvalidCastException

Ein SqlDbType anderes als Binary oder VarBinary wurde verwendet, wenn Value auf Stream festgelegt wurde. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).

- oder -

Ein SqlDbType anderes als Char, NChar, NVarChar, VarChar oder Xml wurde verwendet, wenn Value auf TextReader festgelegt wurde.

Oder

Ein SqlDbType anderer als Xml wurde verwendet, wenn Value auf XmlReader festgelegt wurde.

ArgumentException

Ein ungültiger CommandBehavior-Wert.

InvalidOperationException

ExecuteReaderAsync(CommandBehavior, CancellationToken) wird vor dem Abschluss der Aufgabe mehrmals für dieselbe Instanz aufgerufen.

- oder -

Die SqlConnection wurde während eines Streamingvorgangs geschlossen oder getrennt. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).

SqlException

SQL Server hat beim Ausführen des Befehlstexts einen Fehler zurückgegeben.

- oder -

Bei einem Streamingvorgang ist ein Timeout aufgetreten. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).

IOException

Während eines Streamingvorgangs ist ein Fehler in einem Stream - XmlReader oder TextReader -Objekt aufgetreten. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).

ObjectDisposedException

Das Stream - XmlReader oder TextReader -Objekt wurde während eines Streamingvorgangs geschlossen. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).

Hinweise

Weitere Informationen zur asynchronen Programmierung im .NET Framework-Datenanbieter für SQL Server finden Sie unter Asynchrone Programmierung.