DbConnection.OpenAsync Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 |
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
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
Attività che rappresenta l'operazione asincrona.
Eccezioni
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().