SqlCommand.ExecuteReaderAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Inicia la ejecución asincrónica de la instrucción Transact-SQL o del procedimiento almacenado descrito por este SqlCommand.
Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.
Sobrecargas
| Nombre | Description |
|---|---|
| ExecuteReaderAsync() |
Una versión asincrónica de ExecuteReader(), que envía CommandText a Connection y compila un SqlDataReaderobjeto . Las excepciones se notificarán a través del objeto Task devuelto. Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient. |
| ExecuteReaderAsync(CommandBehavior) |
Una versión asincrónica de ExecuteReader(CommandBehavior), que envía CommandText a Connectiony compila un SqlDataReaderobjeto . Las excepciones se notificarán a través del objeto Task devuelto. |
| ExecuteReaderAsync(CancellationToken) |
Una versión asincrónica de ExecuteReader(), que envía CommandText a Connection y compila un SqlDataReaderobjeto . |
| ExecuteReaderAsync(CommandBehavior, CancellationToken) |
Una versión asincrónica de ExecuteReader(CommandBehavior), que envía CommandText a Connectiony compila un objeto . SqlDataReader |
Comentarios
Para obtener más información sobre la programación asincrónica en la Proveedor de datos de .NET Framework para SQL Server, consulte Asynchronous Programming.
ExecuteReaderAsync()
Una versión asincrónica de ExecuteReader(), que envía CommandText a Connection y compila un SqlDataReaderobjeto . Las excepciones se notificarán a través del objeto Task devuelto.
Para el nuevo desarrollo, use Microsoft. Data.SqlClient. Esta página documenta System.Data.SqlClient.
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)Devoluciones
Tarea que representa la operación asincrónica.
Excepciones
Se usó un SqlDbType valor distinto de Binary o VarBinary cuando Value se estableció en Stream. Para obtener más información sobre el streaming, consulte Compatibilidad con streaming de SqlClient.
O bien
Se usó un SqlDbType valor distinto de Char, NChar, NVarChar, VarChar o Xml cuando Value se estableció en TextReader.
O bien
Se usó un SqlDbType valor distinto de Xml cuando Value se estableció en XmlReader.
Valor no válido CommandBehavior .
Llamar a ExecuteReaderAsync() más de una vez para la misma instancia antes de la finalización de la tarea.
O bien
Cerrado SqlConnection o quitado durante una operación de streaming. Para obtener más información sobre el streaming, consulte Compatibilidad con streaming de SqlClient.
O bien
Context Connection=true se especifica en el cadena de conexión.
SQL Server devolvió un error al ejecutar el texto del comando.
O bien
Se ha agotado el tiempo de espera durante una operación de streaming. Para obtener más información sobre el streaming, consulte Compatibilidad con streaming de SqlClient.
Error en un Streamobjeto , XmlReader o TextReader durante una operación de streaming. Para obtener más información sobre el streaming, consulte Compatibilidad con streaming de SqlClient.
El Streamobjeto , XmlReader o TextReader se cerró durante una operación de streaming. Para obtener más información sobre el streaming, consulte Compatibilidad con streaming de SqlClient.
Comentarios
Para obtener más información sobre la programación asincrónica en la Proveedor de datos de .NET Framework para SQL Server, consulte Asynchronous Programming.
Este método almacena en la tarea que devuelve todas las excepciones de no uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por ExecuteReader().
Consulte también
Se aplica a
ExecuteReaderAsync(CommandBehavior)
Una versión asincrónica de ExecuteReader(CommandBehavior), que envía CommandText a Connectiony compila un SqlDataReaderobjeto . Las excepciones se notificarán a través del objeto Task devuelto.
<p>For new development, use <a href="/sql/connect/ado-net/introduction-microsoft-data-sqlclient-namespace">Microsoft.Data.SqlClient</a>. This page documents System.Data.SqlClient.</p>
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)Parámetros
- behavior
- CommandBehavior
Opciones para la ejecución de instrucciones y la recuperación de datos. Cuando se establece Defaulten , ReadAsync(CancellationToken) lee toda la fila antes de devolver una tarea completa.
Devoluciones
Tarea que representa la operación asincrónica.
Excepciones
Se usó un SqlDbType valor distinto de Binary o VarBinary cuando Value se estableció en Stream. Para obtener más información sobre el streaming, consulte Compatibilidad con streaming de SqlClient.
O bien
Se usó un SqlDbType valor distinto de Char, NChar, NVarChar, VarChar o Xml cuando Value se estableció en TextReader.
O bien
Se usó un SqlDbType valor distinto de Xml cuando Value se estableció en XmlReader.
Valor no válido CommandBehavior .
Llamar a ExecuteReaderAsync(CommandBehavior) más de una vez para la misma instancia antes de la finalización de la tarea.
O bien
Cerrado SqlConnection o quitado durante una operación de streaming. Para obtener más información sobre el streaming, consulte Compatibilidad con streaming de SqlClient.
O bien
Context Connection=true se especifica en el cadena de conexión.
SQL Server devolvió un error al ejecutar el texto del comando.
O bien
Se ha agotado el tiempo de espera durante una operación de streaming. Para obtener más información sobre el streaming, consulte Compatibilidad con streaming de SqlClient.
Error en un Streamobjeto , XmlReader o TextReader durante una operación de streaming. Para obtener más información sobre el streaming, consulte Compatibilidad con streaming de SqlClient.
El Streamobjeto , XmlReader o TextReader se cerró durante una operación de streaming. Para obtener más información sobre el streaming, consulte Compatibilidad con streaming de SqlClient.
Comentarios
Para obtener más información sobre la programación asincrónica en la Proveedor de datos de .NET Framework para SQL Server, consulte Asynchronous Programming.
Este método almacena en la tarea que devuelve todas las excepciones de no uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por ExecuteReader(CommandBehavior).
Consulte también
Se aplica a
ExecuteReaderAsync(CancellationToken)
Una versión asincrónica de ExecuteReader(), que envía CommandText a Connection y compila un SqlDataReaderobjeto .
The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object.
<p>For new development, use <a href="/sql/connect/ado-net/introduction-microsoft-data-sqlclient-namespace">Microsoft.Data.SqlClient</a>. This page documents System.Data.SqlClient.</p>
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)Parámetros
- cancellationToken
- CancellationToken
Instrucción de cancelación.
Devoluciones
Tarea que representa la operación asincrónica.
Excepciones
Se usó un SqlDbType valor distinto de Binary o VarBinary cuando Value se estableció en Stream. Para obtener más información sobre el streaming, consulte Compatibilidad con streaming de SqlClient.
O bien
Se usó un SqlDbType valor distinto de Char, NChar, NVarChar, VarChar o Xml cuando Value se estableció en TextReader.
O bien
Se usó un SqlDbType valor distinto de Xml cuando Value se estableció en XmlReader.
Valor no válido CommandBehavior .
Llamar a ExecuteReaderAsync(CommandBehavior, CancellationToken) más de una vez para la misma instancia antes de la finalización de la tarea.
O bien
Cerrado SqlConnection o quitado durante una operación de streaming. Para obtener más información sobre el streaming, consulte Compatibilidad con streaming de SqlClient.
O bien
Context Connection=true se especifica en el cadena de conexión.
SQL Server devolvió un error al ejecutar el texto del comando.
O bien
Se ha agotado el tiempo de espera durante una operación de streaming. Para obtener más información sobre el streaming, consulte Compatibilidad con streaming de SqlClient.
Error en un Streamobjeto , XmlReader o TextReader durante una operación de streaming. Para obtener más información sobre el streaming, consulte Compatibilidad con streaming de SqlClient.
El Streamobjeto , XmlReader o TextReader se cerró durante una operación de streaming. Para obtener más información sobre el streaming, consulte Compatibilidad con streaming de SqlClient.
Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.
Comentarios
Para obtener más información sobre la programación asincrónica en la Proveedor de datos de .NET Framework para SQL Server, consulte Asynchronous Programming.
Este método almacena en la tarea que devuelve todas las excepciones de no uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por ExecuteReader().
Consulte también
Se aplica a
ExecuteReaderAsync(CommandBehavior, CancellationToken)
Una versión asincrónica de ExecuteReader(CommandBehavior), que envía CommandText a Connectiony compila un objeto . SqlDataReader
The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object.
<p>For new development, use <a href="/sql/connect/ado-net/introduction-microsoft-data-sqlclient-namespace">Microsoft.Data.SqlClient</a>. This page documents System.Data.SqlClient.</p>
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)Parámetros
- behavior
- CommandBehavior
Opciones para la ejecución de instrucciones y la recuperación de datos. Cuando se establece Defaulten , ReadAsync(CancellationToken) lee toda la fila antes de devolver una tarea completa.
- cancellationToken
- CancellationToken
Instrucción de cancelación.
Devoluciones
Tarea que representa la operación asincrónica.
Excepciones
Se usó un SqlDbType valor distinto de Binary o VarBinary cuando Value se estableció en Stream. Para obtener más información sobre el streaming, consulte Compatibilidad con streaming de SqlClient.
O bien
Se usó un SqlDbType valor distinto de Char, NChar, NVarChar, VarChar o Xml cuando Value se estableció en TextReader.
O bien
Se usó un SqlDbType valor distinto de Xml cuando Value se estableció en XmlReader.
Valor no válido CommandBehavior .
Llamar a ExecuteReaderAsync(CommandBehavior, CancellationToken) más de una vez para la misma instancia antes de la finalización de la tarea.
O bien
Cerrado SqlConnection o quitado durante una operación de streaming. Para obtener más información sobre el streaming, consulte Compatibilidad con streaming de SqlClient.
O bien
Context Connection=true se especifica en el cadena de conexión.
SQL Server devolvió un error al ejecutar el texto del comando.
O bien
Se ha agotado el tiempo de espera durante una operación de streaming. Para obtener más información sobre el streaming, consulte Compatibilidad con streaming de SqlClient.
Error en un Streamobjeto , XmlReader o TextReader durante una operación de streaming. Para obtener más información sobre el streaming, consulte Compatibilidad con streaming de SqlClient.
El Streamobjeto , XmlReader o TextReader se cerró durante una operación de streaming. Para obtener más información sobre el streaming, consulte Compatibilidad con streaming de SqlClient.
Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.
Comentarios
Para obtener más información sobre la programación asincrónica en la Proveedor de datos de .NET Framework para SQL Server, consulte Asynchronous Programming.
Este método almacena en la tarea que devuelve todas las excepciones de no uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por ExecuteReader(CommandBehavior).
