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
| Nome | Descrizione |
|---|---|
| OpenAsync() |
Versione asincrona di , che apre una connessione di Open()database con le impostazioni specificate da ConnectionString. Questo metodo richiama il metodo OpenAsync(CancellationToken) virtuale 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ò essere facoltativamente rispettato. L'implementazione predefinita richiama la chiamata sincrona Open() e restituisce un'attività completata. L'implementazione predefinita restituirà un'attività annullata se è stato passato un oggetto cancellationToken già annullato. Le eccezioni generate da Open verranno comunicate tramite la proprietà Task Exception restituita. Non richiamare altri metodi e proprietà dell'oggetto |
Commenti
Per altre informazioni sulla programmazione asincrona nel provider di dati framework di .NET per SQL Server, vedere Asynchronous Programming.
OpenAsync()
Versione asincrona di , che apre una connessione di Open()database con le impostazioni specificate da ConnectionString. Questo metodo richiama il metodo OpenAsync(CancellationToken) virtuale con CancellationToken.None.
public:
System::Threading::Tasks::Task ^ OpenAsync();public System.Threading.Tasks.Task OpenAsync();member this.OpenAsync : unit -> System.Threading.Tasks.TaskPublic Function OpenAsync () As TaskValori restituiti
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 framework di .NET per SQL Server, vedere Asynchronous Programming.
Questo metodo archivia nell'attività che 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)
Si tratta della versione asincrona di Open(). I provider devono eseguire l'override con un'implementazione appropriata. Il token di annullamento può essere facoltativamente rispettato.
L'implementazione predefinita richiama la chiamata sincrona Open() e restituisce un'attività completata. L'implementazione predefinita restituirà un'attività annullata se è stato passato un oggetto cancellationToken già annullato. Le eccezioni generate da Open verranno comunicate tramite la proprietà Task Exception restituita.
Non richiamare altri metodi e proprietà dell'oggetto DbConnection fino al completamento dell'attività restituita.
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.TaskPublic Overridable Function OpenAsync (cancellationToken As CancellationToken) As TaskParametri
- cancellationToken
- CancellationToken
Istruzione di annullamento.
Valori restituiti
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 framework di .NET per SQL Server, vedere Asynchronous Programming.
Questo metodo archivia nell'attività che 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().