Поделиться через


DbDataSource.OpenConnectionAsync(CancellationToken) Метод

Определение

Асинхронно возвращает новое открытое подключение к базе данных, представленной этим DbDataSource.

public System.Threading.Tasks.ValueTask<System.Data.Common.DbConnection> OpenConnectionAsync (System.Threading.CancellationToken cancellationToken = default);
member this.OpenConnectionAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Data.Common.DbConnection>
Public Function OpenConnectionAsync (Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of DbConnection)

Параметры

cancellationToken
CancellationToken

Токен для отмены асинхронной операции.

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

Новое открытое подключение к базе данных, представленной этим DbDataSource.

Исключения

Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.

Комментарии

Возвращенное подключение уже открыто и готово к немедленному использованию.

За правильное удаление соединения, возвращаемого этим методом, отвечает вызывающий объект. Если это не сделать, это может привести к утечке подключения.

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые OpenConnection().

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