DbConnection.BeginTransactionAsync Метод

Определение

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

System.Data.Common

Сборка:

System.Data.Common.dll

Перегрузки

BeginTransactionAsync(CancellationToken)	Асинхронно начинает транзакцию базы данных.
BeginTransactionAsync(IsolationLevel, CancellationToken)	Асинхронно начинает транзакцию базы данных.

BeginTransactionAsync(CancellationToken)

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

DbConnection.cs

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

public System.Threading.Tasks.ValueTask<System.Data.Common.DbTransaction> BeginTransactionAsync (System.Threading.CancellationToken cancellationToken = default);

member this.BeginTransactionAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Data.Common.DbTransaction>

Public Function BeginTransactionAsync (Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of DbTransaction)

Параметры

cancellationToken

CancellationToken

Необязательный токен для отмены асинхронной операции. Значение по умолчанию — None.

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

ValueTask<DbTransaction>

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

Исключения

OperationCanceledException

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

Комментарии

Если уровень изоляции не указан, используется уровень изоляции по умолчанию для конкретного типа подключения.

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

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

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

BeginTransactionAsync(IsolationLevel, CancellationToken)

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

DbConnection.cs

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

public System.Threading.Tasks.ValueTask<System.Data.Common.DbTransaction> BeginTransactionAsync (System.Data.IsolationLevel isolationLevel, System.Threading.CancellationToken cancellationToken = default);

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

Public Function BeginTransactionAsync (isolationLevel As IsolationLevel, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of DbTransaction)

Параметры

isolationLevel

IsolationLevel

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

cancellationToken

CancellationToken

Необязательный токен для отмены асинхронной операции. Значение по умолчанию — None.

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

ValueTask<DbTransaction>

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

Исключения

OperationCanceledException

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

Комментарии

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

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

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