DbConnection.ChangeDatabaseAsync(String, CancellationToken) Methode

Definition

Ändert asynchron die aktuelle Datenbank für eine offene VerbindungAsynchronously changes the current database for an open connection.

public virtual System.Threading.Tasks.Task ChangeDatabaseAsync (string databaseName, System.Threading.CancellationToken cancellationToken = default);
abstract member ChangeDatabaseAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.ChangeDatabaseAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overridable Function ChangeDatabaseAsync (databaseName As String, Optional cancellationToken As CancellationToken = Nothing) As Task

Parameter

databaseName
String

Der Name der Datenbank für die zu verwendende VerbindungThe name of the database for the connection to use.

cancellationToken
CancellationToken

Ein optionales Token zum Abbrechen des asynchronen Vorgangs.An optional token to cancel the asynchronous operation. Der Standardwert ist None.The default value is None.

Gibt zurück

Task

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

Hinweise

Der im-Parameter angegebene Wert databaseName muss ein gültiger Datenbankname für die aktuelle Instanz sein.The value supplied in the databaseName parameter must be a valid database name for the current instance.

Die Standard Implementierung dieser asynchronen Methode delegiert an die synchrone Entsprechung und gibt einen abgeschlossenen zurück Task , der den aufrufenden Thread potenziell blockiert.The default implementation of this asynchronous method delegates to its synchronous counterpart and returns a completed Task, potentially blocking the calling thread.

Datenanbieter, die die asynchrone Programmierung unterstützen, sollten die Standard Implementierung mithilfe von asynchronen e/a-Vorgängen überschreiben.Data providers that support asynchronous programming should override the default implementation using asynchronous I/O operations.

Gilt für: