DbConnection.OpenAsync 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.
Este método implementa uma versão assíncrona de Open().
Sobrecargas
| Name | Description |
|---|---|
| OpenAsync() |
Uma versão assíncrona de Open(), que abre uma ligação à base de dados com as definições especificadas pelo ConnectionString. Este método invoca o método OpenAsync(CancellationToken) virtual com CancellationToken.None. |
| OpenAsync(CancellationToken) |
Esta é a versão assíncrona de Open(). Os prestadores devem sobrepor-se com uma implementação adequada. O token de cancelamento pode ser opcionalmente aceito. A implementação padrão invoca a chamada síncrona Open() e devolve uma tarefa concluída. A implementação padrão devolverá uma tarefa cancelada se for passada uma cancellationToken já cancelada. As exceções lançadas pelo Open serão comunicadas através da propriedade de Exceção de Tarefa devolvida. Não invoque outros métodos e propriedades do |
Observações
Para mais informações sobre programação assíncrona no .NET Framework Data Provider para SQL Server, consulte Programação Assíncrona.
OpenAsync()
Uma versão assíncrona de Open(), que abre uma ligação à base de dados com as definições especificadas pelo ConnectionString. Este método invoca o método OpenAsync(CancellationToken) virtual com CancellationToken.None.
public:
System::Threading::Tasks::Task ^ OpenAsync();public System.Threading.Tasks.Task OpenAsync();member this.OpenAsync : unit -> System.Threading.Tasks.TaskPublic Function OpenAsync () As TaskDevoluções
Uma tarefa que representa a operação assíncrona.
Observações
Após chamar OpenAsync, State deve regressar Connecting até que o retorno Task seja concluído. Então, se a ligação foi bem-sucedida, State deve devolver Open. Se a ligação falhar, State deve devolver Closed.
Uma chamada para Close tentará cancelar ou encerrar a chamada correspondente OpenAsync .
Para mais informações sobre programação assíncrona no .NET Framework Data Provider para SQL Server, consulte Programação Assíncrona.
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 Open().
Ver também
Aplica-se a
OpenAsync(CancellationToken)
Esta é a versão assíncrona de Open(). Os prestadores devem sobrepor-se com uma implementação adequada. O token de cancelamento pode ser opcionalmente aceito.
A implementação padrão invoca a chamada síncrona Open() e devolve uma tarefa concluída. A implementação padrão devolverá uma tarefa cancelada se for passada uma cancellationToken já cancelada. As exceções lançadas pelo Open serão comunicadas através da propriedade de Exceção de Tarefa devolvida.
Não invoque outros métodos e propriedades do DbConnection objeto até que a tarefa devolvida esteja concluída.
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.TaskPublic Overridable Function OpenAsync (cancellationToken As CancellationToken) As TaskParâmetros
- cancellationToken
- CancellationToken
A instrução de cancelamento.
Devoluções
Uma tarefa que representa a operação assíncrona.
Exceções
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Após chamar OpenAsync, State deve regressar Connecting até que o retorno Task seja concluído. Então, se a ligação foi bem-sucedida, State deve devolver Open. Se a ligação falhar, State deve devolver Closed.
Uma chamada para Close tentará cancelar ou encerrar a chamada correspondente OpenAsync .
Para mais informações sobre programação assíncrona no .NET Framework Data Provider para SQL Server, consulte Programação Assíncrona.
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 Open().