DbDataSource.OpenConnectionAsync(CancellationToken) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Asynchronně vrátí nové otevřené připojení k databázi reprezentované tímto DbDataSourceobjektem .
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
Nové otevřené připojení k databázi reprezentované tímto DbDataSource.
Výjimky
Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.
Poznámky
Vrácené připojení je již otevřené a je připravené k okamžitému použití.
Je odpovědností volajícího správně odstranit připojení vrácené touto metodou. Pokud to neuděláte, může dojít k nevrácení připojení.
Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem OpenConnection().
