DbConnection.ChangeDatabaseAsync(String, CancellationToken) Метод

Определение

Асинхронно изменяет текущую базу данных для открытого подключения.Asynchronously 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

Параметры

databaseName
String

Имя базы данных для используемого подключения.The name of the database for the connection to use.

cancellationToken
CancellationToken

Необязательный токен для отмены асинхронной операции.An optional token to cancel the asynchronous operation. Значение по умолчанию — None.The default value is None.

Возвращаемое значение

Task

Задача, представляющая асинхронную операцию.A task representing the asynchronous operation.

Комментарии

Значение, указываемое в databaseName параметре, должно быть допустимым именем базы данных для текущего экземпляра.The value supplied in the databaseName parameter must be a valid database name for the current instance.

Реализация этого асинхронного метода по умолчанию делегирует его синхронному аналогу и возвращает завершенный Task , потенциально блокирующий вызывающий поток.The default implementation of this asynchronous method delegates to its synchronous counterpart and returns a completed Task, potentially blocking the calling thread.

Поставщики данных, поддерживающие Асинхронное программирование , должны переопределять реализацию по умолчанию с помощью асинхронных операций ввода-вывода.Data providers that support asynchronous programming should override the default implementation using asynchronous I/O operations.

Применяется к