DbConnection.OpenAsync Método

Definição

Esse método implementa uma versão assíncrona de Open().This method implements an asynchronous version of Open().

Sobrecargas

OpenAsync()

Uma versão assíncrona de Open(), que abre uma conexão de banco de dados com as configurações especificadas pelo ConnectionString.An asynchronous version of Open(), which opens a database connection with the settings specified by the ConnectionString. Esse método invoca o método virtual OpenAsync(CancellationToken) com CancellationToken.None.This method invokes the virtual method OpenAsync(CancellationToken) with CancellationToken.None.

OpenAsync(CancellationToken)

Essa é a versão assíncrona de Open().This is the asynchronous version of Open(). Provedores devem substituir com uma implementação apropriada.Providers should override with an appropriate implementation. Opcionalmente, o token de cancelamento pode ser respeitado.The cancellation token can optionally be honored.

A implementação padrão invoca a chamada Open() síncrona e retorna uma tarefa concluída.The default implementation invokes the synchronous Open() call and returns a completed task. A implementação padrão retornará uma tarefa cancelada se já tiver passado um cancellationToken cancelado.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Exceções geradas por Open serão comunicadas por meio da propriedade Exceção de Tarefa retornada.Exceptions thrown by Open will be communicated via the returned Task Exception property.

Não invoque outros métodos e propriedades do objeto DbConnection até a Tarefa retornada ser concluída.Do not invoke other methods and properties of the DbConnection object until the returned Task is complete.

Comentários

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.

OpenAsync()

Uma versão assíncrona de Open(), que abre uma conexão de banco de dados com as configurações especificadas pelo ConnectionString.An asynchronous version of Open(), which opens a database connection with the settings specified by the ConnectionString. Esse método invoca o método virtual OpenAsync(CancellationToken) com CancellationToken.None.This method invokes the virtual method OpenAsync(CancellationToken) with CancellationToken.None.

public:
 System::Threading::Tasks::Task ^ OpenAsync();
public System.Threading.Tasks.Task OpenAsync ();
member this.OpenAsync : unit -> System.Threading.Tasks.Task
Public Function OpenAsync () As Task

Retornos

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

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.

Veja também

OpenAsync(CancellationToken)

Essa é a versão assíncrona de Open().This is the asynchronous version of Open(). Provedores devem substituir com uma implementação apropriada.Providers should override with an appropriate implementation. Opcionalmente, o token de cancelamento pode ser respeitado.The cancellation token can optionally be honored.

A implementação padrão invoca a chamada Open() síncrona e retorna uma tarefa concluída.The default implementation invokes the synchronous Open() call and returns a completed task. A implementação padrão retornará uma tarefa cancelada se já tiver passado um cancellationToken cancelado.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Exceções geradas por Open serão comunicadas por meio da propriedade Exceção de Tarefa retornada.Exceptions thrown by Open will be communicated via the returned Task Exception property.

Não invoque outros métodos e propriedades do objeto DbConnection até a Tarefa retornada ser concluída.Do not invoke other methods and properties of the DbConnection object until the returned Task is complete.

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.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.

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.

Veja também

Aplica-se a