DbDataSource.OpenDbConnectionAsync(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 .
protected virtual System.Threading.Tasks.ValueTask<System.Data.Common.DbConnection> OpenDbConnectionAsync (System.Threading.CancellationToken cancellationToken = default);
abstract member OpenDbConnectionAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Data.Common.DbConnection>
override this.OpenDbConnectionAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Data.Common.DbConnection>
Protected Overridable Function OpenDbConnectionAsync (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
Tato metoda se má přepsat implementací zprostředkovatelů ADO.NET a nejedná se o rozhraní API určené pro uživatele.
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 OpenDbConnection().