SqlConnection.OpenAsync(CancellationToken) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
En asynkron version av Open(), som öppnar en databasanslutning med de egenskapsinställningar som anges av ConnectionString. Annulleringstoken kan användas för att begära att åtgärden avbryts innan tidsgränsen för anslutningen går ut. Undantag sprids via den returnerade aktiviteten. Om tidsgränsen för anslutningen förflutit utan att anslutningen lyckades markeras den returnerade aktiviteten som fel med ett undantag. Implementeringen returnerar en aktivitet utan att blockera anropstråden för både poolade och icke-poolade anslutningar.
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 TaskParametrar
- cancellationToken
- CancellationToken
Instruktionen för annullering.
Returer
En uppgift som representerar den asynkrona åtgärden.
Undantag
Anropa OpenAsync(CancellationToken) mer än en gång för samma instans innan uppgiften slutförs.
Context Connection=true anges i reťazec pripojenia.
En anslutning var inte tillgänglig från anslutningspoolen innan tidsgränsen för anslutningen gick ut.
Eventuella fel som returneras av SQL Server som inträffade när anslutningen öppnades.
Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.
Kommentarer
När du har anropat OpenAsyncState måste du returnera Connecting tills den returnerade har slutförtsTask. Om anslutningen lyckades State måste du sedan returnera Open. Om anslutningen misslyckas State måste du returnera Closed.
Ett anrop till Close försöker avbryta eller stänga motsvarande OpenAsync samtal.
Mer information om asynkron programmering i .NET Framework-Data Provider för SQL Server finns i Asynkron programmering.
Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av Open().