Compartir a través de


SqlCommand.ExecuteReaderAsync Método

Definición

Inicia la ejecución asincrónica de la instrucción de Transact-SQL o del procedimiento almacenado que describe SqlCommand.

Sobrecargas

ExecuteReaderAsync()

Una versión asincrónica de ExecuteReader(), que envía la propiedad CommandText a la propiedad Connection y compila SqlDataReader. Las excepciones se mostrarán a través del objeto Task devuelto.

ExecuteReaderAsync(CommandBehavior)

Versión asincrónica de ExecuteReader(CommandBehavior), que envía la propiedad CommandText a la propiedad Connection y compila 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 la propiedad CommandText a la propiedad Connection y compila SqlDataReader.

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)

Versión asincrónica de ExecuteReader(CommandBehavior), que envía la propiedad CommandText a la propiedad Connection y compila SqlDataReader

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.

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.

ExecuteReaderAsync()

Una versión asincrónica de ExecuteReader(), que envía la propiedad CommandText a la propiedad Connection y compila SqlDataReader. Las excepciones se mostrarán a través del objeto Task devuelto.

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ó Streamen . Para obtener más información sobre el streaming, vea Compatibilidad de transmisión de datos de SqlClient.

o bien

Un SqlDbType valor distinto de Char, NChar, NVarChar, VarChar o Xml se usó cuando Value se estableció TextReaderen .

o bien

Se usó un SqlDbType valor distinto de Xml cuando Value se estableció en XmlReader.

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.

o bien

Context Connection=true se especifica en la cadena de conexión.

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.

Se produjo un error en un objeto Stream, 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 objeto Stream, 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.

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por ExecuteReader().

Consulte también

Se aplica a

ExecuteReaderAsync(CommandBehavior)

Versión asincrónica de ExecuteReader(CommandBehavior), que envía la propiedad CommandText a la propiedad Connection y compila SqlDataReader. Las excepciones se mostrarán a través del objeto Task devuelto.

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 en Default, ReadAsync(CancellationToken) lee la fila completa 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ó Streamen . Para obtener más información sobre el streaming, vea Compatibilidad de transmisión de datos de SqlClient.

o bien

Un SqlDbType valor distinto de Char, NChar, NVarChar, VarChar o Xml se usó cuando Value se estableció TextReaderen .

o bien

Se usó un SqlDbType valor distinto de Xml cuando Value se estableció en XmlReader.

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

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.

o bien

Context Connection=true se especifica en la cadena de conexión.

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.

Se produjo un error en un objeto Stream, 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 objeto Stream, 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.

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por ExecuteReader(CommandBehavior).

Consulte también

Se aplica a

ExecuteReaderAsync(CancellationToken)

Una versión asincrónica de ExecuteReader(), que envía la propiedad CommandText a la propiedad Connection y compila SqlDataReader.

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<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ó Streamen . Para obtener más información sobre el streaming, vea Compatibilidad de transmisión de datos de SqlClient.

o bien

Un SqlDbType valor distinto de Char, NChar, NVarChar, VarChar o Xml se usó cuando Value se estableció TextReaderen .

o bien

Se usó un SqlDbType valor distinto de Xml cuando Value se estableció en XmlReader.

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.

o bien

Context Connection=true se especifica en la cadena de conexión.

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.

Se produjo un error en un objeto Stream, 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 objeto Stream, 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.

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 el proveedor de datos de .NET Framework para SQL Server, vea Programación asincrónica.

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por ExecuteReader().

Consulte también

Se aplica a

ExecuteReaderAsync(CommandBehavior, CancellationToken)

Versión asincrónica de ExecuteReader(CommandBehavior), que envía la propiedad CommandText a la propiedad Connection y compila SqlDataReader

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<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 en Default, ReadAsync(CancellationToken) lee la fila completa 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ó Streamen . Para obtener más información sobre el streaming, vea Compatibilidad de transmisión de datos de SqlClient.

o bien

Un SqlDbType valor distinto de Char, NChar, NVarChar, VarChar o Xml se usó cuando Value se estableció TextReaderen .

o bien

Se usó un SqlDbType valor distinto de Xml cuando Value se estableció en XmlReader.

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.

o bien

Context Connection=true se especifica en la cadena de conexión.

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.

Se produjo un error en un objeto Stream, 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 objeto Stream, 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.

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 el proveedor de datos de .NET Framework para SQL Server, vea Programación asincrónica.

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por ExecuteReader(CommandBehavior).

Consulte también

Se aplica a