SqlCommand.ExecuteReaderAsync Methode
Definition
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.
Initiiert die asynchrone Ausführung der Transact-SQL-Anweisung oder der gespeicherten Prozedur, die durch diese SqlCommand beschrieben ist.
Überlädt
| ExecuteReaderAsync() |
Eine asynchrone Version von ExecuteReader(), die den CommandText an die Connection sendet, und einen SqlDataReader erstellt. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet. |
| ExecuteReaderAsync(CommandBehavior) |
Eine asynchrone Version von ExecuteReader(CommandBehavior), die den CommandText an die Connection sendet, und einen SqlDataReader erstellt. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet. |
| ExecuteReaderAsync(CancellationToken) |
Eine asynchrone Version von ExecuteReader(), die den CommandText an die Connection sendet, und einen 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 den CommandText an die Connection sendet, und einen 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. |
Hinweise
Weitere Informationen zur asynchronen Programmierung im .NET Framework-Datenanbieter für SQL Server finden Sie unter Asynchrone Programmierung.
ExecuteReaderAsync()
Eine asynchrone Version von ExecuteReader(), die den CommandText an die Connection sendet, und einen SqlDataReader erstellt. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.
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)Gibt zurück
Eine Aufgabe, die den asynchronen Vorgang darstellt.
Ausnahmen
Es wurde ein anderer SqlDbType als Binary oder VarBinary verwendet, als 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 TextReaderfestgelegt wurde.
- oder -
Es wurde ein anderer SqlDbType als Xml verwendet, als Value auf XmlReader festgelegt wurde.
Ein ungültiger CommandBehavior-Wert.
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).
- oder -
Context Connection=true ist in der Verbindungszeichenfolge angegeben.
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).
Während eines Streamingvorgangs ist bei einem Stream-, XmlReader- oder TextReader-Objekt ein Fehler aufgetreten. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).
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.
Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten ExecuteReader()Ausnahmen.
Weitere Informationen
Gilt für:
ExecuteReaderAsync(CommandBehavior)
Eine asynchrone Version von ExecuteReader(CommandBehavior), die den CommandText an die Connection sendet, und einen SqlDataReader erstellt. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.
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)Parameter
- behavior
- CommandBehavior
Optionen zur Ausführung der Anweisung und zum Datenabruf. Wenn auf Default festgelegt, liest ReadAsync(CancellationToken) die gesamte Zeile, bevor eine vollständige Aufgabe zurückgegeben wird.
Gibt zurück
Eine Aufgabe, die den asynchronen Vorgang darstellt.
Ausnahmen
Es wurde ein anderer SqlDbType als Binary oder VarBinary verwendet, als 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 TextReaderfestgelegt wurde.
- oder -
Es wurde ein anderer SqlDbType als Xml verwendet, als Value auf XmlReader festgelegt wurde.
Ein ungültiger CommandBehavior-Wert.
ExecuteReaderAsync(CommandBehavior) 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).
- oder -
Context Connection=true ist in der Verbindungszeichenfolge angegeben.
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).
Während eines Streamingvorgangs ist bei einem Stream-, XmlReader- oder TextReader-Objekt ein Fehler aufgetreten. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).
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.
Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten ExecuteReader(CommandBehavior)Ausnahmen.
Weitere Informationen
Gilt für:
ExecuteReaderAsync(CancellationToken)
Eine asynchrone Version von ExecuteReader(), die den CommandText an die Connection sendet, und einen 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<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)Parameter
- cancellationToken
- CancellationToken
Die Abbruchanweisung.
Gibt zurück
Eine Aufgabe, die den asynchronen Vorgang darstellt.
Ausnahmen
Es wurde ein anderer SqlDbType als Binary oder VarBinary verwendet, als 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 TextReaderfestgelegt wurde.
- oder -
Es wurde ein anderer SqlDbType als Xml verwendet, als Value auf XmlReader festgelegt wurde.
Ein ungültiger CommandBehavior-Wert.
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).
- oder -
Context Connection=true ist in der Verbindungszeichenfolge angegeben.
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).
Während eines Streamingvorgangs ist bei einem Stream-, XmlReader- oder TextReader-Objekt ein Fehler aufgetreten. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).
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).
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Weitere Informationen zur asynchronen Programmierung im .NET Framework-Datenanbieter für SQL Server finden Sie unter Asynchrone Programmierung.
Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten ExecuteReader()Ausnahmen.
Weitere Informationen
Gilt für:
ExecuteReaderAsync(CommandBehavior, CancellationToken)
Eine asynchrone Version von ExecuteReader(CommandBehavior), die den CommandText an die Connection sendet, und einen 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<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)Parameter
- behavior
- CommandBehavior
Optionen zur Ausführung der Anweisung und zum Datenabruf. Wenn auf Default festgelegt, liest ReadAsync(CancellationToken) die gesamte Zeile, bevor eine vollständige Aufgabe zurückgegeben wird.
- cancellationToken
- CancellationToken
Die Abbruchanweisung.
Gibt zurück
Eine Aufgabe, die den asynchronen Vorgang darstellt.
Ausnahmen
Es wurde ein anderer SqlDbType als Binary oder VarBinary verwendet, als 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 TextReaderfestgelegt wurde.
- oder -
Es wurde ein anderer SqlDbType als Xml verwendet, als Value auf XmlReader festgelegt wurde.
Ein ungültiger CommandBehavior-Wert.
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).
- oder -
Context Connection=true ist in der Verbindungszeichenfolge angegeben.
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).
Während eines Streamingvorgangs ist bei einem Stream-, XmlReader- oder TextReader-Objekt ein Fehler aufgetreten. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).
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).
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Weitere Informationen zur asynchronen Programmierung im .NET Framework-Datenanbieter für SQL Server finden Sie unter Asynchrone Programmierung.
Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten ExecuteReader(CommandBehavior)Ausnahmen.
