DbConnection.OpenAsync Método

  • Referencia

Definición

Espacio de nombres:
System.Data.Common
Ensamblado:
System.Data.Common.dll
Ensamblado:
System.Data.dll
Ensamblado:
netstandard.dll

Este método implementa una versión asincrónica de Open().

Sobrecargas

OpenAsync()

Una versión asincrónica de Open(), que abre una conexión a bases de datos con los valores especificados por ConnectionString. Este método invoca el método virtual OpenAsync(CancellationToken) con CancellationToken.None.
OpenAsync(CancellationToken)

Esta es la versión asincrónica de Open(). Los proveedores lo deben reemplazar con una implementación apropiada. El token de cancelación se puede aceptar opcionalmente.

La implementación predeterminada invoca la llamada sincrónica a Open() y devuelve una tarea completada. La implementación predeterminada devolverá una tarea cancelada si se pasa un cancellationToken ya cancelado. Las excepciones producidas por Open se comunicarán mediante la propiedad Task Exception devuelta.

No invoque otros métodos y propiedades del objeto DbConnection hasta que se haya completado 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.

OpenAsync()

Source:
DbConnection.cs
Source:
DbConnection.cs
Source:
DbConnection.cs

Una versión asincrónica de Open(), que abre una conexión a bases de datos con los valores especificados por ConnectionString. Este método invoca el método virtual OpenAsync(CancellationToken) con CancellationToken.None.

public:
 System::Threading::Tasks::Task ^ OpenAsync();
public System.Threading.Tasks.Task OpenAsync ();
member this.OpenAsync : unit -> System.Threading.Tasks.Task
Public Function OpenAsync () As Task

Devoluciones

Task

Tarea que representa la operación asincrónica.

Comentarios

Después de llamar a OpenAsync, debe volver Connecting hasta que se complete el devuelto TaskState. Después, 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 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 Open().

Consulte también

Se aplica a

OpenAsync(CancellationToken)

Source:
DbConnection.cs
Source:
DbConnection.cs
Source:
DbConnection.cs

Esta es la versión asincrónica de Open(). Los proveedores lo deben reemplazar con una implementación apropiada. El token de cancelación se puede aceptar opcionalmente.

La implementación predeterminada invoca la llamada sincrónica a Open() y devuelve una tarea completada. La implementación predeterminada devolverá una tarea cancelada si se pasa un cancellationToken ya cancelado. Las excepciones producidas por Open se comunicarán mediante la propiedad Task Exception devuelta.

No invoque otros métodos y propiedades del objeto DbConnection hasta que se haya completado 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.Task
Public Overridable Function OpenAsync (cancellationToken As CancellationToken) As Task

Parámetros

cancellationToken
CancellationToken

Instrucción de cancelación.

Devoluciones

Task

Tarea que representa la operación asincrónica.

Excepciones

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Comentarios

Después de llamar a OpenAsync, debe volver Connecting hasta que se complete el devuelto TaskState. Después, 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 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 Open().

Consulte también

Se aplica a