SqlConnection.OpenAsync(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 , que abre una conexión de base de Open()datos con la configuración de propiedad especificada por .ConnectionString El token de cancelación se puede usar para solicitar que se abandone la operación antes de que transcurre el tiempo de espera de conexión. Las excepciones se propagarán a través de la tarea devuelta. Si el tiempo de espera de conexión transcurre sin conectarse correctamente, la tarea devuelta se marcará como errónea con una excepción. La implementación devuelve una tarea sin bloquear el subproceso de llamada para las conexiones agrupadas y no agrupadas.
public:
override System::Threading::Tasks::Task ^ OpenAsync(System::Threading::CancellationToken cancellationToken);public override System.Threading.Tasks.Task OpenAsync(System.Threading.CancellationToken cancellationToken);override this.OpenAsync : System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Overrides Function OpenAsync (cancellationToken As CancellationToken) As TaskParámetros
- cancellationToken
- CancellationToken
Instrucción de cancelación.
Devoluciones
Tarea que representa la operación asincrónica.
Excepciones
Llamar a OpenAsync(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.
No había ninguna conexión disponible en el grupo de conexiones antes de que transcurriese el tiempo de espera de la conexión.
Cualquier error devuelto por SQL Server que se produjo al abrir la conexión.
Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.
Comentarios
Después de llamar a OpenAsync, debe devolver Connecting hasta que se complete el devuelto TaskState. A continuación, si la conexión se realizó correctamente, State debe devolver Open. Si se produce un error en la conexión, State debe devolver Closed.
Una llamada a Close intentará cancelar o cerrar la llamada correspondiente OpenAsync .
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 Open().