SqlCommand.ExecuteReaderAsync SqlCommand.ExecuteReaderAsync SqlCommand.ExecuteReaderAsync SqlCommand.ExecuteReaderAsync Method

Definition

Initiiert die asynchrone Ausführung der Transact-SQLTransact-SQL-Anweisung oder der gespeicherter Prozedur, die von diesem SqlCommand beschrieben wird.Initiates the asynchronous execution of the Transact-SQLTransact-SQL statement or stored procedure that is described by this SqlCommand.

Überlädt

ExecuteReaderAsync() ExecuteReaderAsync() ExecuteReaderAsync() ExecuteReaderAsync()

Eine asynchrone Version von ExecuteReader(), die den CommandText an die Connection sendet, und einen SqlDataReader erstellt.An asynchronous version of ExecuteReader(), which sends the CommandText to the Connection and builds a SqlDataReader. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.Exceptions will be reported via the returned Task object.

ExecuteReaderAsync(CommandBehavior) ExecuteReaderAsync(CommandBehavior) ExecuteReaderAsync(CommandBehavior) ExecuteReaderAsync(CommandBehavior)

Eine asynchrone Version von ExecuteReader(CommandBehavior), die den CommandText an die Connection sendet, und einen SqlDataReader erstellt.An asynchronous version of ExecuteReader(CommandBehavior), which sends the CommandText to the Connection, and builds a SqlDataReader. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.Exceptions will be reported via the returned Task object.

ExecuteReaderAsync(CancellationToken) ExecuteReaderAsync(CancellationToken) ExecuteReaderAsync(CancellationToken)

Eine asynchrone Version von ExecuteReader(), die den CommandText an die Connection sendet, und einen SqlDataReader erstellt.An asynchronous version of ExecuteReader(), which sends the CommandText to the Connection and builds a SqlDataReader.

Das Abbruchtoken kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Timeout des Befehls abläuft.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.Exceptions will be reported via the returned Task object.

ExecuteReaderAsync(CommandBehavior, CancellationToken) ExecuteReaderAsync(CommandBehavior, CancellationToken) ExecuteReaderAsync(CommandBehavior, CancellationToken)

Eine asynchrone Version von ExecuteReader(CommandBehavior), die den CommandText an die Connection sendet, und einen SqlDataReader erstellt.An asynchronous version of ExecuteReader(CommandBehavior), which sends the CommandText to the Connection, and builds a SqlDataReader

Das Abbruchtoken kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Timeout des Befehls abläuft.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.Exceptions will be reported via the returned Task object.

Hinweise

Weitere Informationen zur asynchronen Programmierung in der .NET Framework Datenanbieter für SQL Server finden Sie unter asynchrone Programmierung.For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

ExecuteReaderAsync() ExecuteReaderAsync() ExecuteReaderAsync() ExecuteReaderAsync()

Eine asynchrone Version von ExecuteReader(), die den CommandText an die Connection sendet, und einen SqlDataReader erstellt.An asynchronous version of ExecuteReader(), which sends the CommandText to the Connection and builds a SqlDataReader. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.Exceptions will be reported via the returned Task object.

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.A task representing the asynchronous operation.

Ausnahmen

Es wurde ein anderer SqlDbType als Binary oder VarBinary verwendet, als Value auf Stream festgelegt wurde.A SqlDbType other than Binary or VarBinary was used when Value was set to Stream. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).For more information about streaming, see SqlClient Streaming Support.

- oder --or-

Es wurde ein anderer SqlDbType als Char, NChar, NVarChar, VarChar oder Xml verwendet, als Value auf TextReader festgelegt wurde.A SqlDbType other than Char, NChar, NVarChar, VarChar, or Xml was used when Value was set to TextReader.

- oder --or-

Es wurde ein anderer SqlDbType als Xml verwendet, als Value auf XmlReader festgelegt wurde.A SqlDbType other than Xml was used when Value was set to XmlReader.

ExecuteReaderAsync() wird vor dem Abschluss der Aufgabe mehrmals für dieselbe Instanz aufgerufen.Calling ExecuteReaderAsync() more than once for the same instance before task completion.

- oder --or-

Die SqlConnection wurde während eines Streamingvorgangs geschlossen oder getrennt.The SqlConnection closed or dropped during a streaming operation. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).For more information about streaming, see SqlClient Streaming Support.

- oder --or-

Context Connection=true ist in der Verbindungszeichenfolge angegeben.Context Connection=true is specified in the connection string.

SQL Server hat beim Ausführen des Befehlstexts einen Fehler zurückgegeben.SQL Server returned an error while executing the command text.

- oder --or-

Bei einem Streamingvorgang ist ein Timeout aufgetreten.A timeout occurred during a streaming operation. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).For more information about streaming, see SqlClient Streaming Support.

Während eines Streamingvorgangs ist bei einem Stream-, XmlReader- oder TextReader-Objekt ein Fehler aufgetreten.An error occurred in a Stream, XmlReader or TextReader object during a streaming operation. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).For more information about streaming, see SqlClient Streaming Support.

Das Stream-, XmlReader - oder TextReader -Objekt wurde während eines Streamingvorgangs geschlossen.The Stream, XmlReader or TextReader object was closed during a streaming operation. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).For more information about streaming, see SqlClient Streaming Support.

Hinweise

Weitere Informationen zur asynchronen Programmierung in der .NET Framework Datenanbieter für SQL Server finden Sie unter asynchrone Programmierung.For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

Siehe auch

ExecuteReaderAsync(CommandBehavior) ExecuteReaderAsync(CommandBehavior) ExecuteReaderAsync(CommandBehavior) ExecuteReaderAsync(CommandBehavior)

Eine asynchrone Version von ExecuteReader(CommandBehavior), die den CommandText an die Connection sendet, und einen SqlDataReader erstellt.An asynchronous version of ExecuteReader(CommandBehavior), which sends the CommandText to the Connection, and builds a SqlDataReader. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.Exceptions will be reported via the returned Task object.

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

Optionen zur Ausführung der Anweisung und zum Datenabruf.Options for statement execution and data retrieval. Wenn auf Default festgelegt, liest ReadAsync(CancellationToken) die gesamte Zeile, bevor eine vollständige Aufgabe zurückgegeben wird.When is set to Default, ReadAsync(CancellationToken) reads the entire row before returning a complete Task.

Gibt zurück

Eine Aufgabe, die den asynchronen Vorgang darstellt.A task representing the asynchronous operation.

Ausnahmen

Es wurde ein anderer SqlDbType als Binary oder VarBinary verwendet, als Value auf Stream festgelegt wurde.A SqlDbType other than Binary or VarBinary was used when Value was set to Stream. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).For more information about streaming, see SqlClient Streaming Support.

- oder --or-

Es wurde ein anderer SqlDbType als Char, NChar, NVarChar, VarChar oder Xml verwendet, als Value auf TextReader festgelegt wurde.A SqlDbType other than Char, NChar, NVarChar, VarChar, or Xml was used when Value was set to TextReader.

- oder --or-

Es wurde ein anderer SqlDbType als Xml verwendet, als Value auf XmlReader festgelegt wurde.A SqlDbType other than Xml was used when Value was set to XmlReader.

ExecuteReaderAsync(CommandBehavior) wird vor dem Abschluss der Aufgabe mehrmals für dieselbe Instanz aufgerufen.Calling ExecuteReaderAsync(CommandBehavior) more than once for the same instance before task completion.

- oder --or-

Die SqlConnection wurde während eines Streamingvorgangs geschlossen oder getrennt.The SqlConnection closed or dropped during a streaming operation. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).For more information about streaming, see SqlClient Streaming Support.

- oder --or-

Context Connection=true ist in der Verbindungszeichenfolge angegeben.Context Connection=true is specified in the connection string.

SQL Server hat beim Ausführen des Befehlstexts einen Fehler zurückgegeben.SQL Server returned an error while executing the command text.

- oder --or-

Bei einem Streamingvorgang ist ein Timeout aufgetreten.A timeout occurred during a streaming operation. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).For more information about streaming, see SqlClient Streaming Support.

Während eines Streamingvorgangs ist bei einem Stream-, XmlReader- oder TextReader-Objekt ein Fehler aufgetreten.An error occurred in a Stream, XmlReader or TextReader object during a streaming operation. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).For more information about streaming, see SqlClient Streaming Support.

Das Stream-, XmlReader - oder TextReader -Objekt wurde während eines Streamingvorgangs geschlossen.The Stream, XmlReader or TextReader object was closed during a streaming operation. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).For more information about streaming, see SqlClient Streaming Support.

Hinweise

Weitere Informationen zur asynchronen Programmierung in der .NET Framework Datenanbieter für SQL Server finden Sie unter asynchrone Programmierung.For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

Siehe auch

ExecuteReaderAsync(CancellationToken) ExecuteReaderAsync(CancellationToken) ExecuteReaderAsync(CancellationToken)

Eine asynchrone Version von ExecuteReader(), die den CommandText an die Connection sendet, und einen SqlDataReader erstellt.An asynchronous version of ExecuteReader(), which sends the CommandText to the Connection and builds a SqlDataReader.

Das Abbruchtoken kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Timeout des Befehls abläuft.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.Exceptions will be reported via the returned Task object.

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>

Parameter

cancellationToken
CancellationToken CancellationToken CancellationToken CancellationToken

Die Abbruchanweisung.The cancellation instruction.

Gibt zurück

Eine Aufgabe, die den asynchronen Vorgang darstellt.A task representing the asynchronous operation.

Ausnahmen

Es wurde ein anderer SqlDbType als Binary oder VarBinary verwendet, als Value auf Stream festgelegt wurde.A SqlDbType other than Binary or VarBinary was used when Value was set to Stream. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).For more information about streaming, see SqlClient Streaming Support.

- oder --or-

Es wurde ein anderer SqlDbType als Char, NChar, NVarChar, VarChar oder Xml verwendet, als Value auf TextReader festgelegt wurde.A SqlDbType other than Char, NChar, NVarChar, VarChar, or Xml was used when Value was set to TextReader.

- oder --or- Es wurde ein anderer SqlDbType als Xml verwendet, als Value auf XmlReader festgelegt wurde.A SqlDbType other than Xml was used when Value was set to XmlReader.

ExecuteReaderAsync(CommandBehavior, CancellationToken) wird vor dem Abschluss der Aufgabe mehrmals für dieselbe Instanz aufgerufen.Calling ExecuteReaderAsync(CommandBehavior, CancellationToken) more than once for the same instance before task completion.

- oder --or-

Die SqlConnection wurde während eines Streamingvorgangs geschlossen oder getrennt.The SqlConnection closed or dropped during a streaming operation. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).For more information about streaming, see SqlClient Streaming Support.

- oder --or-

Context Connection=true ist in der Verbindungszeichenfolge angegeben.Context Connection=true is specified in the connection string.

SQL Server hat beim Ausführen des Befehlstexts einen Fehler zurückgegeben.SQL Server returned an error while executing the command text.

- oder --or-

Bei einem Streamingvorgang ist ein Timeout aufgetreten.A timeout occurred during a streaming operation. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).For more information about streaming, see SqlClient Streaming Support.

Während eines Streamingvorgangs ist bei einem Stream-, XmlReader- oder TextReader-Objekt ein Fehler aufgetreten.An error occurred in a Stream, XmlReader or TextReader object during a streaming operation. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).For more information about streaming, see SqlClient Streaming Support.

Das Stream-, XmlReader - oder TextReader -Objekt wurde während eines Streamingvorgangs geschlossen.The Stream, XmlReader or TextReader object was closed during a streaming operation. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).For more information about streaming, see SqlClient Streaming Support.

Hinweise

Weitere Informationen zur asynchronen Programmierung in der .NET Framework Datenanbieter für SQL Server finden Sie unter asynchrone Programmierung.For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

Siehe auch

ExecuteReaderAsync(CommandBehavior, CancellationToken) ExecuteReaderAsync(CommandBehavior, CancellationToken) ExecuteReaderAsync(CommandBehavior, CancellationToken)

Eine asynchrone Version von ExecuteReader(CommandBehavior), die den CommandText an die Connection sendet, und einen SqlDataReader erstellt.An asynchronous version of ExecuteReader(CommandBehavior), which sends the CommandText to the Connection, and builds a SqlDataReader

Das Abbruchtoken kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Timeout des Befehls abläuft.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Ausnahmen werden über das zurückgegebene Aufgabenobjekt gemeldet.Exceptions will be reported via the returned Task object.

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>

Parameter

behavior
CommandBehavior CommandBehavior CommandBehavior CommandBehavior

Optionen zur Ausführung der Anweisung und zum Datenabruf.Options for statement execution and data retrieval. Wenn auf Defaultfestgelegt, liest ReadAsync(CancellationToken) die gesamte Zeile, bevor eine vollständige Aufgabe zurückgegeben wird.When is set to Default, ReadAsync(CancellationToken) reads the entire row before returning a complete Task.

cancellationToken
CancellationToken CancellationToken CancellationToken CancellationToken

Die Abbruchanweisung.The cancellation instruction.

Gibt zurück

Eine Aufgabe, die den asynchronen Vorgang darstellt.A task representing the asynchronous operation.

Ausnahmen

Es wurde ein anderer SqlDbType als Binary oder VarBinary verwendet, als Value auf Stream festgelegt wurde.A SqlDbType other than Binary or VarBinary was used when Value was set to Stream. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).For more information about streaming, see SqlClient Streaming Support.

- oder --or-

Es wurde ein anderer SqlDbType als Char, NChar, NVarChar, VarChar oder Xml verwendet, als Value auf TextReader festgelegt wurde.A SqlDbType other than Char, NChar, NVarChar, VarChar, or Xml was used when Value was set to TextReader.

- oder --or-

Es wurde ein anderer SqlDbType als Xml verwendet, als Value auf XmlReader festgelegt wurde.A SqlDbType other than Xml was used when Value was set to XmlReader.

ExecuteReaderAsync(CommandBehavior, CancellationToken) wird vor dem Abschluss der Aufgabe mehrmals für dieselbe Instanz aufgerufen.Calling ExecuteReaderAsync(CommandBehavior, CancellationToken) more than once for the same instance before task completion.

- oder --or-

Die SqlConnection wurde während eines Streamingvorgangs geschlossen oder getrennt.The SqlConnection closed or dropped during a streaming operation. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).For more information about streaming, see SqlClient Streaming Support.

- oder --or-

Context Connection=true ist in der Verbindungszeichenfolge angegeben.Context Connection=true is specified in the connection string.

SQL Server hat beim Ausführen des Befehlstexts einen Fehler zurückgegeben.SQL Server returned an error while executing the command text.

- oder --or-

Bei einem Streamingvorgang ist ein Timeout aufgetreten.A timeout occurred during a streaming operation. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).For more information about streaming, see SqlClient Streaming Support.

Während eines Streamingvorgangs ist bei einem Stream-, XmlReader- oder TextReader-Objekt ein Fehler aufgetreten.An error occurred in a Stream, XmlReader or TextReader object during a streaming operation. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).For more information about streaming, see SqlClient Streaming Support.

Das Stream-, XmlReader - oder TextReader -Objekt wurde während eines Streamingvorgangs geschlossen.The Stream, XmlReader or TextReader object was closed during a streaming operation. Weitere Informationen zum Streaming finden Sie unter SqlClient Streaming Support (SqlClient-Streamingunterstützung).For more information about streaming, see SqlClient Streaming Support.

Hinweise

Weitere Informationen zur asynchronen Programmierung in der .NET Framework Datenanbieter für SQL Server finden Sie unter asynchrone Programmierung.For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

Siehe auch

Gilt für: