DbConnection.OpenAsync Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Data.Common
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll

Questo metodo implementa una versione asincrona di Open().

Overload

OpenAsync()

Versione asincrona di Open(), che apre una connessione di database con le impostazioni specificate da ConnectionString. Questo metodo richiama il metodo virtuale OpenAsync(CancellationToken) con CancellationToken.None.
OpenAsync(CancellationToken)

Si tratta della versione asincrona di Open(). I provider devono eseguire l'override con un'implementazione appropriata. Il token di annullamento può facoltativamente essere rispettato.

L'implementazione predefinita richiama la chiamata sincrona Open() e restituisce un'attività completata. L'implementazione predefinita restituirà un'attività annullata se viene passato un cancellationToken già annullato. Le eccezioni generate da Open verranno passate mediante la proprietà Task Exception restituita.

Non richiamare altri metodi e proprietà dell'oggetto DbConnection finché l'attività restituita non viene completata.

Commenti

Per altre informazioni sulla programmazione asincrona nel provider di dati .NET Framework per SQL Server, vedere Programmazione asincrona.

OpenAsync()

Source:
DbConnection.cs
Source:
DbConnection.cs
Source:
DbConnection.cs

Versione asincrona di Open(), che apre una connessione di database con le impostazioni specificate da ConnectionString. Questo metodo richiama il metodo virtuale OpenAsync(CancellationToken) con 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

Task

Attività che rappresenta l'operazione asincrona.

Commenti

Dopo aver chiamato OpenAsync, deve restituire Connecting fino al completamento dell'oggetto restituito TaskState. Quindi, se la connessione ha avuto esito positivo, State deve restituire Open. Se la connessione non riesce, State deve restituire Closed.

Una chiamata a Close tenterà di annullare o chiudere la chiamata corrispondente OpenAsync .

Per altre informazioni sulla programmazione asincrona nel provider di dati .NET Framework per SQL Server, vedere Programmazione asincrona.

Questo metodo archivia nell'attività restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da Open().

Vedi anche

Si applica a

OpenAsync(CancellationToken)

Source:
DbConnection.cs
Source:
DbConnection.cs
Source:
DbConnection.cs

Si tratta della versione asincrona di Open(). I provider devono eseguire l'override con un'implementazione appropriata. Il token di annullamento può facoltativamente essere rispettato.

L'implementazione predefinita richiama la chiamata sincrona Open() e restituisce un'attività completata. L'implementazione predefinita restituirà un'attività annullata se viene passato un cancellationToken già annullato. Le eccezioni generate da Open verranno passate mediante la proprietà Task Exception restituita.

Non richiamare altri metodi e proprietà dell'oggetto DbConnection finché l'attività restituita non viene completata.

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
Public Overridable Function OpenAsync (cancellationToken As CancellationToken) As Task

Parametri

cancellationToken
CancellationToken

L'istruzione di annullamento.

Restituisce

Task

Attività che rappresenta l'operazione asincrona.

Eccezioni

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

Dopo aver chiamato OpenAsync, deve restituire Connecting fino al completamento dell'oggetto restituito TaskState. Quindi, se la connessione ha avuto esito positivo, State deve restituire Open. Se la connessione non riesce, State deve restituire Closed.

Una chiamata a Close tenterà di annullare o chiudere la chiamata corrispondente OpenAsync .

Per altre informazioni sulla programmazione asincrona nel provider di dati .NET Framework per SQL Server, vedere Programmazione asincrona.

Questo metodo archivia nell'attività restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da Open().

Vedi anche

Si applica a