DbDataSource.OpenConnectionAsync(CancellationToken) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Devolve assíncronamente uma nova ligação aberta à base de dados 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
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
A ligação devolvida já está aberta e pronta para uso imediato.
É responsabilidade do chamador eliminar corretamente a ligação devolvida por este método. A falha em fazê-lo pode resultar numa fuga na ligação.
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 OpenConnection().
