DbDataSource.OpenConnectionAsync(CancellationToken) Método

Definición

Espacio de nombres:

System.Data.Common

Ensamblado:

System.Data.Common.dll

Source:

DbDataSource.cs

Devuelve de forma asincrónica una nueva conexión abierta a la base de datos representada por este DbDataSource.

public System.Threading.Tasks.ValueTask<System.Data.Common.DbConnection> OpenConnectionAsync (System.Threading.CancellationToken cancellationToken = default);

member this.OpenConnectionAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Data.Common.DbConnection>

Public Function OpenConnectionAsync (Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of DbConnection)

Parámetros

cancellationToken

CancellationToken

Token para cancelar la operación asincrónica.

Devoluciones

ValueTask<DbConnection>

Una nueva conexión abierta a la base de datos representada por este DbDataSource.

Excepciones

OperationCanceledException

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

Comentarios

La conexión devuelta ya está abierta y está lista para su uso inmediato.

Es responsabilidad del autor de la llamada eliminar correctamente la conexión devuelta por este método. Si no lo hace, se puede producir una fuga de conexión.

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 OpenConnection().