DbDataSource.OpenDbConnectionAsync(CancellationToken) Método

Definição

Devolve assíncronamente uma nova ligação aberta à base de dados representada por este DbDataSource.

protected virtual System.Threading.Tasks.ValueTask<System.Data.Common.DbConnection> OpenDbConnectionAsync(System.Threading.CancellationToken cancellationToken = default);
abstract member OpenDbConnectionAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Data.Common.DbConnection>
override this.OpenDbConnectionAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Data.Common.DbConnection>
Protected Overridable Function OpenDbConnectionAsync (Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of DbConnection)

Parâmetros

cancellationToken
CancellationToken

Um token para cancelar a operação assíncrona.

Devoluções

Uma nova ligação aberta à base de dados representada por este DbDataSource.

Exceções

O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.

Observações

Este método destina-se a ser ultrapassado pela implementação de fornecedores ADO.NET e não é uma API voltada para o utilizador.

Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por OpenDbConnection().

Aplica-se a