DbConnection.BeginDbTransactionAsync Метод

Определение

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

System.Data.Common

Сборка:

System.Data.Common.dll

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

DbConnection.cs

Асинхронно запускает транзакцию в базе данных.

protected:
 virtual System::Threading::Tasks::ValueTask<System::Data::Common::DbTransaction ^> BeginDbTransactionAsync(System::Data::IsolationLevel isolationLevel, System::Threading::CancellationToken cancellationToken);

protected virtual System.Threading.Tasks.ValueTask<System.Data.Common.DbTransaction> BeginDbTransactionAsync (System.Data.IsolationLevel isolationLevel, System.Threading.CancellationToken cancellationToken);

abstract member BeginDbTransactionAsync : System.Data.IsolationLevel * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Data.Common.DbTransaction>
override this.BeginDbTransactionAsync : System.Data.IsolationLevel * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Data.Common.DbTransaction>

Protected Overridable Function BeginDbTransactionAsync (isolationLevel As IsolationLevel, cancellationToken As CancellationToken) As ValueTask(Of DbTransaction)

Параметры

isolationLevel

IsolationLevel

Одно из значений перечисления, задающих уровень изоляции используемой транзакции.

cancellationToken

CancellationToken

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

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

ValueTask<DbTransaction>

Задача, свойство Result которой является объектом, представляющим новую транзакцию.

Исключения

OperationCanceledException

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

Комментарии

Реализация этого асинхронного метода по умолчанию делегирует его синхронному аналогу и возвращает завершенный Taskобъект , потенциально блокирующий вызывающий поток.

Поставщики данных, поддерживающие асинхронное программирование , должны переопределять реализацию по умолчанию с помощью асинхронных операций ввода-вывода.

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