DbConnection.OpenAsync 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í.
Este método implementa una versión asincrónica de Open().
Sobrecargas
| Nombre | Description |
|---|---|
| OpenAsync() |
Una versión asincrónica de , que abre una conexión de base de Open()datos con la configuración especificada por .ConnectionString Este método invoca el método OpenAsync(CancellationToken) virtual con CancellationToken.None. |
| OpenAsync(CancellationToken) |
Esta es la versión asincrónica de Open(). Los proveedores deben invalidar con una implementación adecuada. Opcionalmente, se puede respetar el token de cancelación. La implementación predeterminada invoca la llamada sincrónica Open() y devuelve una tarea completada. La implementación predeterminada devolverá una tarea cancelada si se pasa una cancellationToken ya cancelada. Las excepciones producidas por Open se comunicarán a través de la propiedad Task Exception devuelta. No invoque otros métodos y propiedades del |
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.
OpenAsync()
Una versión asincrónica de , que abre una conexión de base de Open()datos con la configuración especificada por .ConnectionString Este método invoca el método OpenAsync(CancellationToken) virtual con CancellationToken.None.
public:
System::Threading::Tasks::Task ^ OpenAsync();public System.Threading.Tasks.Task OpenAsync();member this.OpenAsync : unit -> System.Threading.Tasks.TaskPublic Function OpenAsync () As TaskDevoluciones
Tarea que representa la operación asincrónica.
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().
Consulte también
Se aplica a
OpenAsync(CancellationToken)
Esta es la versión asincrónica de Open(). Los proveedores deben invalidar con una implementación adecuada. Opcionalmente, se puede respetar el token de cancelación.
La implementación predeterminada invoca la llamada sincrónica Open() y devuelve una tarea completada. La implementación predeterminada devolverá una tarea cancelada si se pasa una cancellationToken ya cancelada. Las excepciones producidas por Open se comunicarán a través de la propiedad Task Exception devuelta.
No invoque otros métodos y propiedades del DbConnection objeto hasta que se complete la tarea devuelta.
public:
virtual System::Threading::Tasks::Task ^ OpenAsync(System::Threading::CancellationToken cancellationToken);public virtual System.Threading.Tasks.Task OpenAsync(System.Threading.CancellationToken cancellationToken);abstract member OpenAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.OpenAsync : System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Overridable 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
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().