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í.
Sobrecargas
| ExecuteReaderAsync() |
Una versión asincrónica de ExecuteReader() , que envía a CommandTextConnection y compila un SqlDataReader objeto . Las excepciones se mostrarán a través del objeto Task devuelto. |
| ExecuteReaderAsync(CommandBehavior) |
Una versión asincrónica de ExecuteReader(CommandBehavior) , que envía CommandText a Connection y compila un SqlDataReader . Las excepciones se mostrarán a través del objeto Task devuelto. |
| ExecuteReaderAsync(CancellationToken) |
Una versión asincrónica de ExecuteReader() , que envía a CommandTextConnection y compila un SqlDataReader objeto . Token de cancelación que se puede usar para solicitar que se abandone la operación antes de que transcurra el tiempo de espera del comando. Las excepciones se mostrarán a través del objeto Task devuelto. |
| ExecuteReaderAsync(CommandBehavior, CancellationToken) |
Una versión asincrónica de ExecuteReader(CommandBehavior) , que envía CommandText a Connection y compila un SqlDataReader token de cancelación se puede usar para solicitar que la operación se abandone antes de que transcurre el tiempo de espera del comando. Las excepciones se mostrarán a través del objeto Task devuelto. |
ExecuteReaderAsync()
Una versión asincrónica de ExecuteReader() , que envía a CommandTextConnection y compila un SqlDataReader objeto . Las excepciones se mostrarán a través del objeto Task devuelto.
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)Devoluciones
Tarea que representa la operación asincrónica.
Excepciones
Se usó un SqlDbType valor distinto de Binary o VarBinary cuando Value se estableció Stream en . Para obtener más información sobre el streaming, vea Compatibilidad de transmisión de datos de SqlClient.
o bien
Se usó un SqlDbType valor distinto de Char, NChar, NVarChar, VarChar o Xml cuando Value se estableció TextReader en .
O bien
Se usó un SqlDbType valor distinto de Xml cuando Value se estableció XmlReader en .
Hay un valor de CommandBehavior no válido.
Llamar a ExecuteReaderAsync() más de una vez para la misma instancia antes de la finalización de la tarea.
o bien
La SqlConnection se cerró o se interrumpió durante una operación de streaming. Para obtener más información sobre el streaming, vea Compatibilidad de transmisión de datos de SqlClient.
SQL Server informó de un error al ejecutar el texto del comando.
o bien
Se agotó el tiempo de espera durante una operación de streaming. Para obtener más información sobre el streaming, vea Compatibilidad de transmisión de datos de SqlClient.
Error en un Stream objeto , XmlReader o TextReader durante una operación de streaming. Para obtener más información sobre el streaming, vea Compatibilidad de transmisión de datos de SqlClient.
El Stream objeto , XmlReader o TextReader se cerró durante una operación de streaming. Para obtener más información sobre el streaming, vea Compatibilidad de transmisión de datos de SqlClient.
Comentarios
Para obtener más información sobre la programación asincrónica en el proveedor de datos de .NET Framework para SQL Server, vea Programación asincrónica.
Nota
Para consultas de larga duración en el servidor, considere la posibilidad de usar ExecuteReader debido a un problema conocido con la cancelación de consultas a través de un token de cancelación. Además, considere la posibilidad de cancelar la ejecución mediante el Cancel método .
Se aplica a
ExecuteReaderAsync(CommandBehavior)
Una versión asincrónica de ExecuteReader(CommandBehavior) , que envía CommandText a Connection y compila un SqlDataReader . Las excepciones se mostrarán a través del objeto Task devuelto.
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)Parámetros
- behavior
- CommandBehavior
Opciones para la ejecución de instrucciones y la recuperación de datos. Cuando se establece enDefault , 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ó Stream en . Para obtener más información sobre el streaming, vea Compatibilidad de transmisión de datos de SqlClient.
o bien
Se usó un SqlDbType valor distinto de Char, NChar, NVarChar, VarChar o Xml cuando Value se estableció TextReader en .
O bien
Se usó un SqlDbType valor distinto de Xml cuando Value se estableció XmlReader en .
Hay un valor de CommandBehavior no válido.
Llamar a ExecuteReaderAsync(CommandBehavior) más de una vez para la misma instancia antes de la finalización de la tarea.
-o bien- SqlConnection cerrado o quitado durante una operación de streaming. Para obtener más información sobre el streaming, vea Compatibilidad de transmisión de datos de SqlClient.
SQL Server informó de un error al ejecutar el texto del comando.
o bien
Se agotó el tiempo de espera durante una operación de streaming. Para obtener más información sobre el streaming, vea Compatibilidad de transmisión de datos de SqlClient.
Error en un Stream objeto , XmlReader o TextReader durante una operación de streaming. Para obtener más información sobre el streaming, vea Compatibilidad de transmisión de datos de SqlClient.
El Stream objeto , XmlReader o TextReader se cerró durante una operación de streaming. Para obtener más información sobre el streaming, vea Compatibilidad de transmisión de datos de SqlClient.
Comentarios
Para obtener más información sobre la programación asincrónica en el proveedor de datos de .NET Framework para SQL Server, vea Programación asincrónica.
Se aplica a
ExecuteReaderAsync(CancellationToken)
Una versión asincrónica de ExecuteReader() , que envía a CommandTextConnection y compila un SqlDataReader objeto .
Token de cancelación que se puede usar para solicitar que se abandone la operación antes de que transcurra el tiempo de espera del comando. Las excepciones se mostrarán a través del objeto Task devuelto.
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)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ó Stream en . Para obtener más información sobre el streaming, vea Compatibilidad de transmisión de datos de SqlClient.
o bien
Se usó un SqlDbType valor distinto de Char, NChar, NVarChar, VarChar o Xml cuando Value se estableció TextReader en .
O bien
Se usó un SqlDbType valor distinto de Xml cuando Value se estableció XmlReader en .
Hay un valor de CommandBehavior no válido.
Llamar a ExecuteReaderAsync(CommandBehavior, CancellationToken) más de una vez para la misma instancia antes de la finalización de la tarea.
o bien
La SqlConnection se cerró o se interrumpió durante una operación de streaming. Para obtener más información sobre el streaming, vea Compatibilidad de transmisión de datos de SqlClient.
SQL Server informó de un error al ejecutar el texto del comando.
o bien
Se agotó el tiempo de espera durante una operación de streaming. Para obtener más información sobre el streaming, vea Compatibilidad de transmisión de datos de SqlClient.
Error en un Stream objeto , XmlReader o TextReader durante una operación de streaming. Para obtener más información sobre el streaming, vea Compatibilidad de transmisión de datos de SqlClient.
El Stream objeto , XmlReader o TextReader se cerró durante una operación de streaming. Para obtener más información sobre el streaming, vea Compatibilidad de transmisión de datos de SqlClient.
Comentarios
Para obtener más información sobre la programación asincrónica en el proveedor de datos de .NET Framework para SQL Server, vea Programación asincrónica.
Se aplica a
ExecuteReaderAsync(CommandBehavior, CancellationToken)
Una versión asincrónica de ExecuteReader(CommandBehavior) , que envía CommandText a Connection y compila un SqlDataReader token de cancelación se puede usar para solicitar que se abandone la operación antes de que transcurre el tiempo de espera del comando. Las excepciones se mostrarán a través del objeto Task devuelto.
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)Parámetros
- behavior
- CommandBehavior
Opciones para la ejecución de instrucciones y la recuperación de datos. Cuando se establece enDefault , 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ó Stream en . Para obtener más información sobre el streaming, vea Compatibilidad de transmisión de datos de SqlClient.
o bien
Se usó un SqlDbType valor distinto de Char, NChar, NVarChar, VarChar o Xml cuando Value se estableció TextReader en .
O bien
Se usó un SqlDbType valor distinto de Xml cuando Value se estableció XmlReader en .
Hay un valor de CommandBehavior no válido.
Llamar a ExecuteReaderAsync(CommandBehavior, CancellationToken) más de una vez para la misma instancia antes de la finalización de la tarea.
o bien
La SqlConnection se cerró o se interrumpió durante una operación de streaming. Para obtener más información sobre el streaming, vea Compatibilidad de transmisión de datos de SqlClient.
SQL Server informó de un error al ejecutar el texto del comando.
o bien
Se agotó el tiempo de espera durante una operación de streaming. Para obtener más información sobre el streaming, vea Compatibilidad de transmisión de datos de SqlClient.
Error en un Stream objeto o XmlReaderTextReader durante una operación de streaming. Para obtener más información sobre el streaming, vea Compatibilidad de transmisión de datos de SqlClient.
El Stream objeto , XmlReader o TextReader se cerró durante una operación de streaming. Para obtener más información sobre el streaming, vea Compatibilidad de transmisión de datos de SqlClient.
Comentarios
Para obtener más información sobre la programación asincrónica en el proveedor de datos de .NET Framework para SQL Server, vea Programación asincrónica.