SqlDataReader.ReadAsync(CancellationToken) 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í.
Una versión asincrónica de Read(), que avanza SqlDataReader al siguiente registro.
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:
override System::Threading::Tasks::Task<bool> ^ ReadAsync(System::Threading::CancellationToken cancellationToken);public override System.Threading.Tasks.Task<bool> ReadAsync(System.Threading.CancellationToken cancellationToken);override this.ReadAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>Public Overrides Function ReadAsync (cancellationToken As CancellationToken) As Task(Of Boolean)Parámetros
- cancellationToken
- CancellationToken
Instrucción de cancelación.
Devoluciones
Tarea que representa la operación asincrónica.
Excepciones
Llamar a ReadAsync(CancellationToken) más de una vez para la misma instancia antes de la finalización de la tarea.
Context Connection=true se especifica en el cadena de conexión.
SQL Server devolvió un error al ejecutar el texto del comando.
Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.
Comentarios
Si el behavior parámetro de ExecuteReaderAsync se establece Defaulten , ReadAsync lee toda la fila antes de devolver la tarea.
Para obtener más información, incluidos los ejemplos de código, sobre la programación asincrónica en el Proveedor de datos de .NET Framework para SQL Server, vea 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 Read().