DbDataSource.OpenConnectionAsync(CancellationToken) Metoda

Definicja

Przestrzeń nazw:

System.Data.Common

Zestaw:

System.Data.Common.dll

Źródło:

DbDataSource.cs

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

ValueTask<DbConnection>

Nowe, otwarte połączenie z bazą danych reprezentowane przez ten DbDataSourceelement .

Wyjątki

OperationCanceledException

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ę .