SqlConnection.OpenAsync(CancellationToken) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Eine asynchrone Version von Open(), die eine Datenbankverbindung mit den eigenschafteneinstellungen öffnet, die durch die ConnectionString. Das Abbruchtoken kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Verbindungstimeout verstrichen ist. Ausnahmen werden über den zurückgegebenen Vorgang weitergegeben. Wenn die Zeitüberschreitung der Verbindung ohne erfolgreiche Verbindung verstrichen ist, wird der zurückgegebene Vorgang mit einer Ausnahme als fehlerhaft markiert. Die Implementierung gibt eine Aufgabe zurück, ohne den aufrufenden Thread für poolierte und nicht poolierte Verbindungen zu blockieren.
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 TaskParameter
- cancellationToken
- CancellationToken
Die Abbruchanweisung.
Gibt zurück
Eine Aufgabe, die den asynchronen Vorgang darstellt.
Ausnahmen
Mehrere Aufrufe OpenAsync(CancellationToken) für dieselbe Instanz vor Abschluss der Aufgabe.
Context Connection=true wird im Verbindungszeichenfolge angegeben.
Vor ablauf des Verbindungstimeouts war keine Verbindung aus dem Verbindungspool verfügbar.
Alle fehler, die von SQL Server zurückgegeben wurden, die beim Öffnen der Verbindung aufgetreten sind.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Nach dem Aufrufen OpenAsyncmuss zurückgesendet Connecting werden, State bis der zurückgegebene Task Vorgang abgeschlossen ist. Wenn die Verbindung erfolgreich war, State muss die Rückgabe erfolgen Open. Wenn die Verbindung fehlschlägt, State muss sie zurückgegeben werden Closed.
Ein Anruf versucht, Close den entsprechenden OpenAsync Anruf abzubrechen oder zu schließen.
Weitere Informationen zur asynchronen Programmierung im .NET Framework-Datenanbieter für SQL Server finden Sie unter Asynchrone Programmierung.
Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Open().