SqlCommand.ExecuteReaderAsync Methode

Definition

Namespace:: Microsoft.Data.SqlClient

Assembly:: Microsoft.Data.SqlClient.dll

Paket:: Microsoft.Data.SqlClient v1.0.19269.1

Paket:: Microsoft.Data.SqlClient v1.1.4

Paket:: Microsoft.Data.SqlClient v2.0.1

Paket:: Microsoft.Data.SqlClient v2.1.4

Paket:: Microsoft.Data.SqlClient v3.0.1

Paket:: Microsoft.Data.SqlClient v3.1.0

Paket:: Microsoft.Data.SqlClient v4.0.1

Paket:: Microsoft.Data.SqlClient v4.1.0

Paket:: Microsoft.Data.SqlClient v5.0.0

Paket:: Microsoft.Data.SqlClient v5.1.0

Paket:: Microsoft.Data.SqlClient v5.2.0

Paket:: Microsoft.Data.SqlClient v6.0.2

Paket:: Microsoft.Data.SqlClient v6.1.3

Paket:: Microsoft.Data.SqlClient v7.0.1

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Überlädt

Name	Beschreibung
ExecuteReaderAsync()	Eine asynchrone Version von ExecuteReader(), die die CommandText an die Connection und erstellt eine SqlDataReader. Ausnahmen werden über das zurückgegebene Task-Objekt gemeldet.
ExecuteReaderAsync(CommandBehavior)	Eine asynchrone Version von ExecuteReader(CommandBehavior), die die CommandText an die Connection, und erstellt eine SqlDataReader. Ausnahmen werden über das zurückgegebene Task-Objekt gemeldet.
ExecuteReaderAsync(CancellationToken)	Eine asynchrone Version von ExecuteReader(), die die CommandText an die Connection und erstellt eine SqlDataReader. Das Abbruchtoken kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Befehlstimeout verstrichen ist. Ausnahmen werden über das zurückgegebene Task-Objekt gemeldet.
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Eine asynchrone Version von ExecuteReader(CommandBehavior), die die CommandText Ansage Connectionsendet und erstellt ein SqlDataReader Abbruchtoken kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Befehlstimeout verstrichen ist. Ausnahmen werden über das zurückgegebene Task-Objekt gemeldet.

ExecuteReaderAsync()

Quelle:: SqlCommand.cs

Quelle:: SqlCommand.cs

Quelle:: SqlCommand.cs

Quelle:: SqlCommand.cs

Eine asynchrone Version von ExecuteReader(), die die CommandText an die Connection und erstellt eine SqlDataReader. Ausnahmen werden über das zurückgegebene Task-Objekt 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

Eine SqlDbType andere als Binary oder VarBinary wurde verwendet, als Value festgelegt Streamwurde. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support.
Ein SqlDbType anderer als Char, NChar, NVarChar, , VarCharoder Xml wurde verwendet, als Value festgelegt TextReaderwurde .
Ein SqlDbType anderer als Xml der Zeitpunkt, an Valuedem XmlReader festgelegt wurde.

ArgumentException

Ein ungültiger CommandBehavior Wert.

InvalidOperationException

Mehrere Aufrufe ExecuteReaderAsync() für dieselbe Instanz vor Abschluss der Aufgabe.
Das SqlConnection Schließen oder Ablegen während eines Streamingvorgangs. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support.

SqlException

SQL Server beim Ausführen des Befehlstexts einen Fehler zurückgegeben.
Während eines Streamingvorgangs ist ein Timeout aufgetreten. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support.

IOException

Fehler in einem StreamOder XmlReader TextReader Objekt während eines Streamingvorgangs. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support.

ObjectDisposedException

Das StreamObjekt XmlReader wurde TextReader während eines Streamingvorgangs geschlossen. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support.

Hinweise

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

Note

Bei lang ausgeführten Abfragen auf dem Server sollten Sie die Verwendung ExecuteReader aufgrund eines bekannten Problems beim Abbrechen von Abfragen über ein Abbruchtoken in Betracht ziehen. Erwägen Sie außerdem, die Ausführung mithilfe der Cancel Methode abzubrechen.

Gilt für:

ExecuteReaderAsync(CommandBehavior)

Quelle:: SqlCommand.cs

Quelle:: SqlCommand.cs

Quelle:: SqlCommand.cs

Quelle:: SqlCommand.cs

Eine asynchrone Version von ExecuteReader(CommandBehavior), die die CommandText an die Connection, und erstellt eine SqlDataReader. Ausnahmen werden über das zurückgegebene Task-Objekt 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 für anweisungsausführung und Datenabruf. Wenn dieser Wert auf <a0/> festgelegt ist, wird die gesamte Zeile vor dem Zurückgeben einer abgeschlossenen Aufgabe gelesen.

Gibt zurück

Task<SqlDataReader>

Eine Aufgabe, die den asynchronen Vorgang darstellt.

Ausnahmen

InvalidCastException

Eine SqlDbType andere als Binary oder VarBinary wurde verwendet, als Value festgelegt Streamwurde. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support.
Ein SqlDbType anderer als Char, NChar, NVarChar, , VarCharoder Xml wurde verwendet, als Value festgelegt TextReaderwurde .
Ein SqlDbType anderer als Xml der Zeitpunkt, an Valuedem XmlReader festgelegt wurde.

ArgumentException

Ein ungültiger CommandBehavior Wert.

InvalidOperationException

Mehrere Aufrufe ExecuteReaderAsync(CommandBehavior) für dieselbe Instanz vor Abschluss der Aufgabe.
SqlConnection geschlossen oder während eines Streamingvorgangs verworfen. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support.

SqlException

SQL Server beim Ausführen des Befehlstexts einen Fehler zurückgegeben.
Während eines Streamingvorgangs ist ein Timeout aufgetreten. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support.

IOException

Fehler in einem StreamOder XmlReader TextReader Objekt während eines Streamingvorgangs. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support.

ObjectDisposedException

Das StreamObjekt XmlReader wurde TextReader während eines Streamingvorgangs geschlossen. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support.

Hinweise

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

Gilt für:

ExecuteReaderAsync(CancellationToken)

Quelle:: SqlCommand.cs

Quelle:: SqlCommand.cs

Quelle:: SqlCommand.cs

Quelle:: SqlCommand.cs

Eine asynchrone Version von ExecuteReader(), die die CommandText an die Connection und erstellt eine SqlDataReader. Das Abbruchtoken kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Befehlstimeout verstrichen ist. Ausnahmen werden über das zurückgegebene Task-Objekt 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

Eine SqlDbType andere als Binary oder VarBinary wurde verwendet, als Value festgelegt Streamwurde. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support.
Ein SqlDbType anderer als Char, NChar, NVarChar, , VarCharoder Xml wurde verwendet, als Value festgelegt TextReaderwurde .
Ein SqlDbType anderer als Xml der Zeitpunkt, an Valuedem XmlReader festgelegt wurde.

ArgumentException

Ein ungültiger CommandBehavior Wert.

InvalidOperationException

Mehrere Aufrufe ExecuteReaderAsync(CommandBehavior, CancellationToken) für dieselbe Instanz vor Abschluss der Aufgabe.
Das SqlConnection Schließen oder Ablegen während eines Streamingvorgangs. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support.

SqlException

SQL Server beim Ausführen des Befehlstexts einen Fehler zurückgegeben.
Während eines Streamingvorgangs ist ein Timeout aufgetreten. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support.

IOException

Fehler in einem StreamOder XmlReader TextReader Objekt während eines Streamingvorgangs. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support.

ObjectDisposedException

Das StreamObjekt XmlReader wurde TextReader während eines Streamingvorgangs geschlossen. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support.

Hinweise

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

Gilt für:

ExecuteReaderAsync(CommandBehavior, CancellationToken)

Quelle:: SqlCommand.cs

Quelle:: SqlCommand.cs

Quelle:: SqlCommand.cs

Quelle:: SqlCommand.cs

Eine asynchrone Version von ExecuteReader(CommandBehavior), die die CommandText Ansage Connectionsendet und erstellt ein SqlDataReader Abbruchtoken kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Befehlstimeout verstrichen ist. Ausnahmen werden über das zurückgegebene Task-Objekt 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 für anweisungsausführung und Datenabruf. Wenn dieser Wert auf <a0/> festgelegt ist, wird die gesamte Zeile vor dem Zurückgeben einer abgeschlossenen Aufgabe gelesen.

cancellationToken: CancellationToken

Die Abbruchanweisung.

Gibt zurück

Task<SqlDataReader>

Eine Aufgabe, die den asynchronen Vorgang darstellt.

Ausnahmen

InvalidCastException

Eine SqlDbType andere als Binary oder VarBinary wurde verwendet, als Value festgelegt Streamwurde. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support.
Ein SqlDbType anderer als Char, NChar, NVarChar, , VarCharoder Xml wurde verwendet, als Value festgelegt TextReaderwurde .
Ein SqlDbType anderer als Xml der Zeitpunkt, an Valuedem XmlReader festgelegt wurde.

ArgumentException

Ein ungültiger CommandBehavior Wert.

InvalidOperationException

Mehrere Aufrufe ExecuteReaderAsync(CommandBehavior, CancellationToken) für dieselbe Instanz vor Abschluss der Aufgabe.
Das SqlConnection Schließen oder Ablegen während eines Streamingvorgangs. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support.

SqlException

SQL Server beim Ausführen des Befehlstexts einen Fehler zurückgegeben.
Während eines Streamingvorgangs ist ein Timeout aufgetreten. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support.

IOException

Fehler in einem StreamOder XmlReader TextReader Objekt während eines Streamingvorgangs. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support.

ObjectDisposedException

Das StreamObjekt XmlReader wurde TextReader während eines Streamingvorgangs geschlossen. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support.

Hinweise

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

Gilt für: