DbConnection.OpenAsync 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.
Den här metoden implementerar en asynkron version av Open().
Överlagringar
| Name | Description |
|---|---|
| OpenAsync() |
En asynkron version av Open(), som öppnar en databasanslutning med de inställningar som anges av ConnectionString. Den här metoden anropar den virtuella metoden OpenAsync(CancellationToken) med CancellationToken.None. |
| OpenAsync(CancellationToken) |
Det här är den asynkrona versionen av Open(). Leverantörer bör åsidosätta med en lämplig implementering. Annulleringstoken kan också respekteras. Standardimplementeringen anropar det synkrona Open() anropet och returnerar en slutförd uppgift. Standardimplementeringen returnerar en avbruten aktivitet om den redan har avbrutitsToken. Undantag som utlöses av Open kommer att kommuniceras via den returnerade egenskapen Aktivitetsfel. Anropa inte andra metoder och egenskaper för |
Kommentarer
Mer information om asynkron programmering i .NET Framework-Data Provider för SQL Server finns i Asynkron programmering.
OpenAsync()
En asynkron version av Open(), som öppnar en databasanslutning med de inställningar som anges av ConnectionString. Den här metoden anropar den virtuella metoden OpenAsync(CancellationToken) med CancellationToken.None.
public:
System::Threading::Tasks::Task ^ OpenAsync();public System.Threading.Tasks.Task OpenAsync();member this.OpenAsync : unit -> System.Threading.Tasks.TaskPublic Function OpenAsync () As TaskReturer
En uppgift som representerar den asynkrona åtgärden.
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().
Se även
Gäller för
OpenAsync(CancellationToken)
Det här är den asynkrona versionen av Open(). Leverantörer bör åsidosätta med en lämplig implementering. Annulleringstoken kan också respekteras.
Standardimplementeringen anropar det synkrona Open() anropet och returnerar en slutförd uppgift. Standardimplementeringen returnerar en avbruten aktivitet om den redan har avbrutitsToken. Undantag som utlöses av Open kommer att kommuniceras via den returnerade egenskapen Aktivitetsfel.
Anropa inte andra metoder och egenskaper för DbConnection objektet förrän den returnerade aktiviteten har slutförts.
public:
virtual System::Threading::Tasks::Task ^ OpenAsync(System::Threading::CancellationToken cancellationToken);public virtual System.Threading.Tasks.Task OpenAsync(System.Threading.CancellationToken cancellationToken);abstract member OpenAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.OpenAsync : System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Overridable Function OpenAsync (cancellationToken As CancellationToken) As TaskParametrar
- cancellationToken
- CancellationToken
Instruktionen för annullering.
Returer
En uppgift som representerar den asynkrona åtgärden.
Undantag
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().