DbConnection.OpenAsync Метод

Определение

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

System.Data.Common

Сборки:

netstandard.dll, System.Data.Common.dll

Этот метод реализует асинхронную версию Open().

Перегрузки

Имя	Описание
OpenAsync()	Асинхронная версия Open(), которая открывает подключение к базе данных с параметрами, указанными в параметре ConnectionString. Этот метод вызывает виртуальный метод OpenAsync(CancellationToken) с помощью CancellationToken.None.
OpenAsync(CancellationToken)	Это асинхронная версия Open(). Поставщики должны переопределить соответствующую реализацию. Маркер отмены можно при необходимости учитывать. Реализация по умолчанию вызывает синхронный Open() вызов и возвращает завершенную задачу. Реализация по умолчанию возвращает отмененную задачу, если передана уже отмененная отменаToken. Исключения, создаваемые Open, будут передаваться через возвращаемое свойство "Исключение задачи". Не вызывайте другие методы и свойства DbConnection объекта до завершения возвращаемой задачи.

Комментарии

Дополнительные сведения об асинхронном программировании в Data Provider Data Provider SQL Server см. .NET в разделе Asynchronous Programming.

OpenAsync()

Исходный код:

DbConnection.cs

Асинхронная версия Open(), которая открывает подключение к базе данных с параметрами, указанными в параметре ConnectionString. Этот метод вызывает виртуальный метод OpenAsync(CancellationToken) с помощью CancellationToken.None.

public:
 System::Threading::Tasks::Task ^ OpenAsync();

public System.Threading.Tasks.Task OpenAsync();

member this.OpenAsync : unit -> System.Threading.Tasks.Task

Public Function OpenAsync () As Task

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

Task

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

Комментарии

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

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

Дополнительные сведения об асинхронном программировании в Data Provider Data Provider SQL Server см. .NET в разделе Asynchronous Programming.

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

См. также раздел

• Общие сведения об ADO.NET

OpenAsync(CancellationToken)

Исходный код:

DbConnection.cs

Это асинхронная версия Open(). Поставщики должны переопределить соответствующую реализацию. Маркер отмены можно при необходимости учитывать.

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

Не вызывайте другие методы и свойства DbConnection объекта до завершения возвращаемой задачи.

public:
 virtual System::Threading::Tasks::Task ^ OpenAsync(System::Threading::CancellationToken cancellationToken);

public virtual System.Threading.Tasks.Task OpenAsync(System.Threading.CancellationToken cancellationToken);

abstract member OpenAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.OpenAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function OpenAsync (cancellationToken As CancellationToken) As Task

Параметры

cancellationToken

CancellationToken

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

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

Task

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

Исключения

OperationCanceledException

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

Комментарии

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

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

Дополнительные сведения об асинхронном программировании в Data Provider Data Provider SQL Server см. .NET в разделе Asynchronous Programming.

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

См. также раздел

• Общие сведения об ADO.NET