SqlConnection.OpenAsync(CancellationToken) Método

Definição

Uma versão assíncrona de Open(), que abre uma conexão de banco de dados com as configurações de propriedade especificadas pelo ConnectionString.An asynchronous version of Open(), which opens a database connection with the property settings specified by the ConnectionString. O token de cancelamento pode ser usado para solicitar que a operação seja abandonada antes de expirar o tempo limite da conexão.The cancellation token can be used to request that the operation be abandoned before the connection timeout elapses. Exceções serão propagadas por meio da tarefa retornada.Exceptions will be propagated via the returned Task. Se o tempo limite de conexão sem se conectar com êxito, a tarefa retornada será marcada como com falha com uma exceção.If the connection timeout time elapses without successfully connecting, the returned Task will be marked as faulted with an Exception. A implementação retorna uma tarefa sem bloquear o thread de chamada para conexões em grupo e não agrupada.The implementation returns a Task without blocking the calling thread for both pooled and non-pooled connections.

public:
 override System::Threading::Tasks::Task ^ OpenAsync(System::Threading::CancellationToken cancellationToken);
public override System.Threading.Tasks.Task OpenAsync (System.Threading.CancellationToken cancellationToken);
override this.OpenAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task

Parâmetros

cancellationToken
CancellationToken

A instrução de cancelamento.The cancellation instruction.

Retornos

Uma tarefa que representa a operação assíncrona.A task representing the asynchronous operation.

Exceções

Chamando OpenAsync(CancellationToken) mais de uma vez para a mesma instância antes da conclusão da tarefa.Calling OpenAsync(CancellationToken) more than once for the same instance before task completion.

Context Connection=true é especificado na cadeia de conexão.Context Connection=true is specified in the connection string.

Uma conexão não estava disponível do pool de conexão antes do tempo limite da conexão.A connection was not available from the connection pool before the connection time out elapsed.

Qualquer erro retornado pelo SQL Server, que ocorreu ao abrir a conexão.Any error returned by SQL Server that occurred while opening the connection.

Comentários

Depois de chamar OpenAsync, State deve retornar Connecting até que o Task retornado seja concluído.After calling OpenAsync, State must return Connecting until the returned Task is completed. Em seguida, se a conexão tiver sido bem-sucedida, State deverá retornar Open.Then, if the connection was successful, State must return Open. Se a conexão falhar, State deverá retornar Closed.If the connection fails, State must return Closed.

Uma chamada para Close tentará cancelar ou fechar a chamada OpenAsync correspondente.A call to Close will attempt to cancel or close the corresponding OpenAsync call.

Para obter mais informações sobre a programação assíncrona no Provedor de Dados .NET Framework para SQL Server, consulte programação assíncrona.For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

Aplica-se a

Veja também