SqlConnection.OpenAsync(CancellationToken) SqlConnection.OpenAsync(CancellationToken) SqlConnection.OpenAsync(CancellationToken) Method

Definition

Eine asynchrone Version von Open(), die eine Datenbankverbindung mit den Eigenschaftseinstellungen öffnet, die durch ConnectionString angegeben sind.An asynchronous version of Open(), which opens a database connection with the property settings specified by the ConnectionString. Das Abbruchtoken kann verwendet werden, um anzufordern, dass der Vorgang abgebrochen wird, bevor das Timeout der Verbindung abläuft.The cancellation token can be used to request that the operation be abandoned before the connection timeout elapses. Ausnahmen werden über die zurückgegebene Aufgabe weitergegeben.Exceptions will be propagated via the returned Task. Wenn die Timeout-Zeit für die Verbindung abläuft, ohne die Verbindung erfolgreich herzustellen, wird die zurückgegebene Aufgabe als fehlgeschlagen mit einer Ausnahme markiert.If the connection timeout time elapses without successfully connecting, the returned Task will be marked as faulted with an Exception. Die Implementierung gibt eine Aufgabe zurück, ohne den aufrufenden Verbindungs-Thread zu blockieren (gilt auch für Pool-Verbindungen).The implementation returns a Task without blocking the calling thread for both pooled and non-pooled connections.

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

Parameter

cancellationToken
CancellationToken CancellationToken CancellationToken

Die Abbruchanweisung.The cancellation instruction.

Gibt zurück

Eine Aufgabe, die den asynchronen Vorgang darstellt.A task representing the asynchronous operation.

Ausnahmen

OpenAsync(CancellationToken) wird vor dem Abschluss der Aufgabe mehrmals für dieselbe Instanz aufgerufen.Calling OpenAsync(CancellationToken) more than once for the same instance before task completion.

Context Connection=true ist in der Verbindungszeichenfolge angegeben.Context Connection=true is specified in the connection string.

Es war keine Verbindung aus dem Verbindungspool verfügbar, bevor ein Timeout für die Verbindung aufgetreten ist.A connection was not available from the connection pool before the connection time out elapsed.

Jeder von SQL Server zurückgegebene Fehler, der beim Öffnen der Verbindung aufgetreten ist.Any error returned by SQL Server that occurred while opening the connection.

Hinweise

Nachdem aufgerufen OpenAsyncwurde State , muss Connecting zurückgeben, Task bis die zurückgegebene abgeschlossen ist.After calling OpenAsync, State must return Connecting until the returned Task is completed. Wenn die Verbindung erfolgreich hergestellt wurde, State muss zurückgeben. OpenThen, if the connection was successful, State must return Open. Wenn die Verbindung nicht hergestellt State werden kann Closed, muss zurückgeben.If the connection fails, State must return Closed.

Durch einen-Befehl OpenAsync wirdversucht,denentsprechenden-Befehlabzubrechenoderzuschließen.CloseA call to Close will attempt to cancel or close the corresponding OpenAsync call.

Weitere Informationen zur asynchronen Programmierung in der .NET Framework Datenanbieter für SQL Server finden Sie unter asynchrone Programmierung.For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

Gilt für:

Siehe auch