SqlCommand.ExecuteXmlReaderAsync SqlCommand.ExecuteXmlReaderAsync SqlCommand.ExecuteXmlReaderAsync SqlCommand.ExecuteXmlReaderAsync Method

Definition

Initiiert die asynchrone Ausführung der Transact-SQL-Anweisung oder der gespeicherten Prozedur, die von diesem SqlCommand beschrieben wird, und gibt die Ergebnisse in Form eines XmlReader-Objekts zurück.Initiates the asynchronous execution of the Transact-SQL statement or stored procedure that is described by this SqlCommand and returns results as an XmlReader object.

Überlädt

ExecuteXmlReaderAsync() ExecuteXmlReaderAsync() ExecuteXmlReaderAsync() ExecuteXmlReaderAsync()

Eine asynchrone Version von ExecuteXmlReader(), die CommandText zu Connection sendet, und ein XmlReader-Objekt erstellt.An asynchronous version of ExecuteXmlReader(), which sends the CommandText to the Connection and builds an XmlReader object.

Ausnahmen werden über das zurückgegebene Taskobjekt gemeldet.Exceptions will be reported via the returned Task object.

ExecuteXmlReaderAsync(CancellationToken) ExecuteXmlReaderAsync(CancellationToken) ExecuteXmlReaderAsync(CancellationToken)

Eine asynchrone Version von ExecuteXmlReader(), die CommandText zu Connection sendet, und ein XmlReader-Objekt erstellt.An asynchronous version of ExecuteXmlReader(), which sends the CommandText to the Connection and builds an XmlReader object.

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.

ExecuteXmlReaderAsync() ExecuteXmlReaderAsync() ExecuteXmlReaderAsync() ExecuteXmlReaderAsync()

Eine asynchrone Version von ExecuteXmlReader(), die CommandText zu Connection sendet, und ein XmlReader-Objekt erstellt.An asynchronous version of ExecuteXmlReader(), which sends the CommandText to the Connection and builds an XmlReader object.

Ausnahmen werden über das zurückgegebene Taskobjekt gemeldet.Exceptions will be reported via the returned Task object.

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)

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.

ExecuteScalarAsync(CancellationToken) wird vor dem Abschluss der Aufgabe mehrmals für dieselbe Instanz aufgerufen.Calling ExecuteScalarAsync(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

Der von dieser Methode zurückgegebene XmlReader unterstützt keine asynchronen Vorgänge.The XmlReader returned by this method does not support asynchronous operations.

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

ExecuteXmlReaderAsync(CancellationToken) ExecuteXmlReaderAsync(CancellationToken) ExecuteXmlReaderAsync(CancellationToken)

Eine asynchrone Version von ExecuteXmlReader(), die CommandText zu Connection sendet, und ein XmlReader-Objekt erstellt.An asynchronous version of ExecuteXmlReader(), which sends the CommandText to the Connection and builds an XmlReader object.

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

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.

ExecuteScalarAsync(CancellationToken) wird vor dem Abschluss der Aufgabe mehrmals für dieselbe Instanz aufgerufen.Calling ExecuteScalarAsync(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

Der von dieser Methode zurückgegebene XmlReader unterstützt keine asynchronen Vorgänge.The XmlReader returned by this method does not support asynchronous operations.

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: