DbConnection.OpenAsync Metodo

Definizione

Questo metodo implementa una versione asincrona di Open().This method implements an asynchronous version of Open().

Overload

OpenAsync()

Versione asincrona di Open(), che apre una connessione di database con le impostazioni specificate da ConnectionString.An asynchronous version of Open(), which opens a database connection with the settings specified by the ConnectionString. Questo metodo richiama il metodo virtuale OpenAsync(CancellationToken) con CancellationToken.None.This method invokes the virtual method OpenAsync(CancellationToken) with CancellationToken.None.

OpenAsync(CancellationToken)

Si tratta della versione asincrona di Open().This is the asynchronous version of Open(). I provider devono eseguire l'override con un'implementazione appropriata.Providers should override with an appropriate implementation. Il token di annullamento può facoltativamente essere rispettato.The cancellation token can optionally be honored.

L'implementazione predefinita richiama la chiamata sincrona Open() e restituisce un'attività completata.The default implementation invokes the synchronous Open() call and returns a completed task. L'implementazione predefinita restituirà un'attività annullata se viene passato un cancellationToken già annullato.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Le eccezioni generate da Open verranno passate mediante la proprietà Task Exception restituita.Exceptions thrown by Open will be communicated via the returned Task Exception property.

Non richiamare altri metodi e proprietà dell'oggetto DbConnection finché l'attività restituita non viene completata.Do not invoke other methods and properties of the DbConnection object until the returned Task is complete.

Commenti

Per ulteriori informazioni sulla programmazione asincrona nella .NET Framework provider di dati per SQL Server, vedere programmazione asincrona.For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

OpenAsync()

Versione asincrona di Open(), che apre una connessione di database con le impostazioni specificate da ConnectionString.An asynchronous version of Open(), which opens a database connection with the settings specified by the ConnectionString. Questo metodo richiama il metodo virtuale OpenAsync(CancellationToken) con 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

Restituisce

Attività che rappresenta l'operazione asincrona.A task representing the asynchronous operation.

Commenti

Dopo la chiamata di OpenAsync, State necessario restituire Connecting finché non viene completato il Task restituito.After calling OpenAsync, State must return Connecting until the returned Task is completed. Quindi, se la connessione ha avuto esito positivo, State necessario restituire Open.Then, if the connection was successful, State must return Open. Se la connessione ha esito negativo, State necessario restituire Closed.If the connection fails, State must return Closed.

Una chiamata a Close tenterà di annullare o chiudere la chiamata OpenAsync corrispondente.A call to Close will attempt to cancel or close the corresponding OpenAsync call.

Per ulteriori informazioni sulla programmazione asincrona nella .NET Framework provider di dati per SQL Server, vedere programmazione asincrona.For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

Vedi anche

OpenAsync(CancellationToken)

Si tratta della versione asincrona di Open().This is the asynchronous version of Open(). I provider devono eseguire l'override con un'implementazione appropriata.Providers should override with an appropriate implementation. Il token di annullamento può facoltativamente essere rispettato.The cancellation token can optionally be honored.

L'implementazione predefinita richiama la chiamata sincrona Open() e restituisce un'attività completata.The default implementation invokes the synchronous Open() call and returns a completed task. L'implementazione predefinita restituirà un'attività annullata se viene passato un cancellationToken già annullato.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Le eccezioni generate da Open verranno passate mediante la proprietà Task Exception restituita.Exceptions thrown by Open will be communicated via the returned Task Exception property.

Non richiamare altri metodi e proprietà dell'oggetto DbConnection finché l'attività restituita non viene completata.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

Parametri

cancellationToken
CancellationToken

L'istruzione di annullamento.The cancellation instruction.

Restituisce

Attività che rappresenta l'operazione asincrona.A task representing the asynchronous operation.

Commenti

Dopo la chiamata di OpenAsync, State necessario restituire Connecting finché non viene completato il Task restituito.After calling OpenAsync, State must return Connecting until the returned Task is completed. Quindi, se la connessione ha avuto esito positivo, State necessario restituire Open.Then, if the connection was successful, State must return Open. Se la connessione ha esito negativo, State necessario restituire Closed.If the connection fails, State must return Closed.

Una chiamata a Close tenterà di annullare o chiudere la chiamata OpenAsync corrispondente.A call to Close will attempt to cancel or close the corresponding OpenAsync call.

Per ulteriori informazioni sulla programmazione asincrona nella .NET Framework provider di dati per SQL Server, vedere programmazione asincrona.For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

Vedi anche

Si applica a