DbConnection.OpenAsync Método

Definición

Este método implementa una versión asincrónica de Open().This method implements an asynchronous version of 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.An asynchronous version of Open(), which opens a database connection with the settings specified by the ConnectionString. Este método invoca el método virtual OpenAsync(CancellationToken) con CancellationToken.None.This method invokes the virtual method OpenAsync(CancellationToken) with CancellationToken.None.

OpenAsync(CancellationToken)

Esta es la versión asincrónica de Open().This is the asynchronous version of Open(). Los proveedores lo deben reemplazar con una implementación apropiada.Providers should override with an appropriate implementation. El token de cancelación se puede aceptar opcionalmente.The cancellation token can optionally be honored.

La implementación predeterminada invoca la llamada sincrónica a Open() y devuelve una tarea completada.The default implementation invokes the synchronous Open() call and returns a completed task. La implementación predeterminada devolverá una tarea cancelada si se pasa un cancellationToken ya cancelado.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Las excepciones producidas por Open se comunicarán mediante la propiedad Task Exception devuelta.Exceptions thrown by Open will be communicated via the returned Task Exception property.

No invoque otros métodos y propiedades del objeto DbConnection hasta que se haya completado la tarea devuelta.Do not invoke other methods and properties of the DbConnection object until the returned Task is complete.

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.For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

OpenAsync()

Una versión asincrónica de Open(), que abre una conexión a bases de datos con los valores especificados por ConnectionString.An asynchronous version of Open(), which opens a database connection with the settings specified by the ConnectionString. Este método invoca el método virtual OpenAsync(CancellationToken) con CancellationToken.None.This method invokes the virtual method OpenAsync(CancellationToken) with 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.A task representing the asynchronous operation.

Comentarios

Después de llamar a OpenAsync , State debe devolver Connecting hasta que se complete el valor devuelto Task .After calling OpenAsync, State must return Connecting until the returned Task is completed. Después, si la conexión se realizó correctamente, State debe devolver Open .Then, if the connection was successful, State must return Open. Si se produce un error en la conexión, State debe devolver Closed .If the connection fails, State must return Closed.

Una llamada a Close intentará cancelar o cerrar la llamada correspondiente OpenAsync .A call to Close will attempt to cancel or close the corresponding OpenAsync call.

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.For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

Se aplica a

OpenAsync(CancellationToken)

Esta es la versión asincrónica de Open().This is the asynchronous version of Open(). Los proveedores lo deben reemplazar con una implementación apropiada.Providers should override with an appropriate implementation. El token de cancelación se puede aceptar opcionalmente.The cancellation token can optionally be honored.

La implementación predeterminada invoca la llamada sincrónica a Open() y devuelve una tarea completada.The default implementation invokes the synchronous Open() call and returns a completed task. La implementación predeterminada devolverá una tarea cancelada si se pasa un cancellationToken ya cancelado.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Las excepciones producidas por Open se comunicarán mediante la propiedad Task Exception devuelta.Exceptions thrown by Open will be communicated via the returned Task Exception property.

No invoque otros métodos y propiedades del objeto DbConnection hasta que se haya completado la tarea devuelta.Do not invoke other methods and properties of the DbConnection object until the returned Task is complete.

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.The cancellation instruction.

Devoluciones

Task

Tarea que representa la operación asincrónica.A task representing the asynchronous operation.

Comentarios

Después de llamar a OpenAsync , State debe devolver Connecting hasta que se complete el valor devuelto Task .After calling OpenAsync, State must return Connecting until the returned Task is completed. Después, si la conexión se realizó correctamente, State debe devolver Open .Then, if the connection was successful, State must return Open. Si se produce un error en la conexión, State debe devolver Closed .If the connection fails, State must return Closed.

Una llamada a Close intentará cancelar o cerrar la llamada correspondiente OpenAsync .A call to Close will attempt to cancel or close the corresponding OpenAsync call.

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.For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

Se aplica a