SqlConnection.OpenAsync(CancellationToken) Метод

Определение

Пространство имен:

Microsoft.Data.SqlClient

Сборка:

Microsoft.Data.SqlClient.dll

Пакет:

Microsoft.Data.SqlClient v5.2.0

Асинхронная версия Open(), которая открывает соединение с базой данных с параметрами свойства, указанными в строке ConnectionString. Чтобы запросить отмену операции до истечения времени ожидания соединения, можно использовать токен отмены. Исключения будут распространяться с помощью возвращаемой задачи. Если время ожидания соединения истекло без успешного подключения, возвращаемая задача будет помечена как сбойная с исключением. Реализация возвращает задачу без блокировки вызывающего потока как для соединений, помещенных в пул, так и соединений вне пула.

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

Public Overrides Function OpenAsync (cancellationToken As CancellationToken) As Task

Параметры

cancellationToken

CancellationToken

Инструкция отмены.

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

Task

Задача, представляющая асинхронную операцию.

Исключения

InvalidOperationException

Вызов OpenAsync(CancellationToken) более одного раза для того же экземпляра до завершения задачи.

Подключение не было доступно из пула подключений до истечения времени ожидания подключения.

SqlException

Ошибка, возвращенная SQL Server, которая произошла при открытии соединения.

Комментарии

После вызова OpenAsyncдолжен State возвращать Connecting значение до завершения возвращаемого Task . Затем, если подключение прошло успешно, State необходимо вернуть Open. Если подключение завершается сбоем, State должен возвращать Closed.

Вызов будет Close пытаться отменить или закрыть соответствующий OpenAsync вызов.

Дополнительные сведения об асинхронном программировании в поставщике данных платформа .NET Framework для SQL Server см. в статье Асинхронное программирование.