DbDataSource.OpenConnectionAsync(CancellationToken) Metoda

Definice

Obor názvů:

System.Data.Common

Sestavení:

System.Data.Common.dll

Zdroj:

DbDataSource.cs

Asynchronně vrátí nové otevřené připojení k databázi reprezentované tímto DbDataSource.

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 pro zrušení asynchronní operace.

Návraty

ValueTask<DbConnection>

Nové otevřené připojení k databázi reprezentované tímto DbDataSource.

Výjimky

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka je uložena do vrácené úlohy.

Poznámky

Vrácené připojení je již otevřené a je připravené k okamžitému použití.

Za správné odstranění připojení vráceného touto metodou zodpovídá volající. Pokud to neuděláte, může dojít k úniku připojení.

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané OpenConnection().