SqlConnection.OpenAsync(CancellationToken) 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.
Versione asincrona di , che apre una connessione di Open()database con le impostazioni delle proprietà specificate da ConnectionString. Il token di annullamento può essere usato per richiedere che l'operazione venga abbandonata prima del timeout della connessione. Le eccezioni verranno propagate tramite l'attività restituita. Se il tempo di timeout della connessione è trascorso senza connettersi correttamente, l'attività restituita verrà contrassegnata come difettosa con un'eccezione. L'implementazione restituisce un'attività senza bloccare il thread chiamante per le connessioni in pool e non in pool.
public:
override System::Threading::Tasks::Task ^ OpenAsync(System::Threading::CancellationToken cancellationToken);public override System.Threading.Tasks.Task OpenAsync(System.Threading.CancellationToken cancellationToken);override this.OpenAsync : System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Overrides Function OpenAsync (cancellationToken As CancellationToken) As TaskParametri
- cancellationToken
- CancellationToken
Istruzione di annullamento.
Valori restituiti
Attività che rappresenta l'operazione asincrona.
Eccezioni
Chiamata OpenAsync(CancellationToken) più volte per la stessa istanza prima del completamento dell'attività.
Context Connection=true viene specificato nel stringa di connessione.
Una connessione non era disponibile dal pool di connessioni prima che il timeout della connessione sia trascorso.
Qualsiasi errore restituito da SQL Server che si è verificato durante l'apertura della connessione.
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().