SqlCommand.ExecuteReaderAsync Método

Definición

Espacio de nombres:

Microsoft.Data.SqlClient

Ensamblado:

Microsoft.Data.SqlClient.dll

Paquete:

Microsoft.Data.SqlClient v7.0.1

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.
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 . El 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 notificarán a través del objeto Task devuelto.
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Una versión asincrónica de ExecuteReader(CommandBehavior), que envía CommandText a Connectiony 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 notificarán a través del objeto Task devuelto.

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.

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

Task<SqlDataReader>

Tarea que representa la operación asincrónica.

Excepciones

InvalidCastException

• Que SqlDbType no es o Binary se usó cuando VarBinary se estableció en ValueStream . Para obtener más información sobre el streaming, consulte Compatibilidad con streaming de SqlClient.
• Un SqlDbType valor distinto de Char, NChar, NVarChar, VarCharo Xml se usó cuando Value se estableció en TextReader.
• Que SqlDbType no se usó cuando Xml se estableció en Value.XmlReader

ArgumentException

Valor no válido CommandBehavior .

InvalidOperationException

• Llamar a ExecuteReaderAsync() más de una vez para la misma instancia antes de la finalización de la tarea.
• 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.

SqlException

• SQL Server devolvió un error al ejecutar el texto del comando.
• 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.

IOException

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.

ObjectDisposedException

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.

Note

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 .

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.

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 Defaulten , ReadAsync(CancellationToken) lee toda la fila antes de devolver una tarea completa.

Devoluciones

Task<SqlDataReader>

Tarea que representa la operación asincrónica.

Excepciones

InvalidCastException

• Que SqlDbType no es o Binary se usó cuando VarBinary se estableció en ValueStream . Para obtener más información sobre el streaming, consulte Compatibilidad con streaming de SqlClient.
• Un SqlDbType valor distinto de Char, NChar, NVarChar, VarCharo Xml se usó cuando Value se estableció en TextReader.
• Que SqlDbType no se usó cuando Xml se estableció en Value.XmlReader

ArgumentException

Valor no válido CommandBehavior .

InvalidOperationException

• Llamar a ExecuteReaderAsync(CommandBehavior) más de una vez para la misma instancia antes de la finalización de la tarea.
• SqlConnection cerrado o quitado durante una operación de streaming. Para obtener más información sobre el streaming, consulte Compatibilidad con streaming de SqlClient.

SqlException

• SQL Server devolvió un error al ejecutar el texto del comando.
• 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.

IOException

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.

ObjectDisposedException

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.

ExecuteReaderAsync(CancellationToken)

Una versión asincrónica de ExecuteReader(), que envía CommandText a Connection y compila un SqlDataReaderobjeto . El 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 notificará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

Task<SqlDataReader>

Tarea que representa la operación asincrónica.

Excepciones

InvalidCastException

• Que SqlDbType no es o Binary se usó cuando VarBinary se estableció en ValueStream . Para obtener más información sobre el streaming, consulte Compatibilidad con streaming de SqlClient.
• Un SqlDbType valor distinto de Char, NChar, NVarChar, VarCharo Xml se usó cuando Value se estableció en TextReader.
• Que SqlDbType no se usó cuando Xml se estableció en Value.XmlReader

ArgumentException

Valor no válido CommandBehavior .

InvalidOperationException

• Llamar a ExecuteReaderAsync(CommandBehavior, CancellationToken) más de una vez para la misma instancia antes de la finalización de la tarea.
• 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.

SqlException

• SQL Server devolvió un error al ejecutar el texto del comando.
• 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.

IOException

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.

ObjectDisposedException

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.

ExecuteReaderAsync(CommandBehavior, CancellationToken)

Una versión asincrónica de ExecuteReader(CommandBehavior), que envía CommandText a Connectiony 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 notificará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 Defaulten , ReadAsync(CancellationToken) lee toda la fila antes de devolver una tarea completa.

cancellationToken

CancellationToken

Instrucción de cancelación.

Devoluciones

Task<SqlDataReader>

Tarea que representa la operación asincrónica.

Excepciones

InvalidCastException

• Que SqlDbType no es o Binary se usó cuando VarBinary se estableció en ValueStream . Para obtener más información sobre el streaming, consulte Compatibilidad con streaming de SqlClient.
• Un SqlDbType valor distinto de Char, NChar, NVarChar, VarCharo Xml se usó cuando Value se estableció en TextReader.
• Que SqlDbType no se usó cuando Xml se estableció en Value.XmlReader

ArgumentException

Valor no válido CommandBehavior .

InvalidOperationException

• Llamar a ExecuteReaderAsync(CommandBehavior, CancellationToken) más de una vez para la misma instancia antes de la finalización de la tarea.
• 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.

SqlException

• SQL Server devolvió un error al ejecutar el texto del comando.
• 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.

IOException

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.

ObjectDisposedException

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.