DbDataSource.OpenConnectionAsync(CancellationToken) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Asynchronicznie zwraca nowe, otwarte połączenie z bazą danych reprezentowaną przez tę DbDataSourcemetodę .
public System.Threading.Tasks.ValueTask<System.Data.Common.DbConnection> OpenConnectionAsync (System.Threading.CancellationToken cancellationToken = default);
member this.OpenConnectionAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Data.Common.DbConnection>
Public Function OpenConnectionAsync (Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of DbConnection)
Parametry
- cancellationToken
- CancellationToken
Token umożliwiający anulowanie operacji asynchronicznej.
Zwraca
Nowe, otwarte połączenie z bazą danych reprezentowane przez ten DbDataSourceelement .
Wyjątki
Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.
Uwagi
Zwrócone połączenie jest już otwarte i jest gotowe do natychmiastowego użycia.
Jest to odpowiedzialność obiektu wywołującego za prawidłowe usuwanie połączenia zwróconego przez tę metodę. Nie można tego zrobić, może spowodować wyciek połączenia.
Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez OpenConnection()usługę .