SqlConnection.OpenAsync(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í verze nástroje Open(), která otevře připojení k databázi s nastavením vlastností určeným parametrem ConnectionString. Pomocí tokenu zrušení je možné požádat o opuštění operace před vypršením časového limitu připojení. Výjimky se rozšíří prostřednictvím vrácené úlohy. Pokud časový limit připojení uplyne bez úspěšného připojení, vrácená úloha se označí jako chybná s výjimkou. Implementace vrátí úlohu bez blokování volajícího vlákna pro připojení ve fondu i bez fondu připojení.
public:
override System::Threading::Tasks::Task ^ OpenAsync(System::Threading::CancellationToken cancellationToken);public override System.Threading.Tasks.Task OpenAsync (System.Threading.CancellationToken cancellationToken);override this.OpenAsync : System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Overrides Function OpenAsync (cancellationToken As CancellationToken) As TaskParametry
- cancellationToken
- CancellationToken
Instrukce zrušení
Návraty
Úloha představující asynchronní operaci
Výjimky
Volání OpenAsync(CancellationToken) více než jednou pro stejnou instanci před dokončením úlohy.
Context Connection=trueje zadaný v připojovací řetězec.
Před vypršením časového limitu připojení nebylo z fondu připojení k dispozici připojení.
Všechny chyby vrácené SQL Server, ke kterým došlo při otevírání připojení.
Token zrušení byl zrušen. Tato výjimka se uloží do vrácené úlohy.
Poznámky
Po volání OpenAsyncState se musí vrátitConnecting, dokud se vrácená Task hodnota nedokončila. Pokud bylo připojení úspěšné, State musí vrátit .Open Pokud připojení selže, State musí vrátit .Closed
Volání se Close pokusí zrušit nebo zavřít odpovídající OpenAsync hovor.
Další informace o asynchronním programování ve zprostředkovateli dat rozhraní .NET Framework pro SQL Server najdete v tématu Asynchronní programování.
Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Open().
