Sdílet prostřednictvím


SqlConnection.OpenAsync(CancellationToken) Metoda

Definice

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.Task
Public Overrides Function OpenAsync (cancellationToken As CancellationToken) As Task

Parametry

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().

Platí pro

Viz také