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

Parameter

databaseName
String

Der Name der Datenbank für die zu verwendende Verbindung.The 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. Standardwert: None.The default value is None.

Gibt zurück

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

Hinweise

Der im databaseName-Parameter angegebene Wert 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 eine abgeschlossene Taskzurück, die möglicherweise den aufrufenden Thread 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 standardmäßige inmplementierung mithilfe von asynchronen e/a-Vorgängen überschreiben.Data providers that support asynchronous programming should override the default inmplementation using asynchronous I/O operations.

Gilt für: