DbConnection.BeginTransactionAsync Метод

Определение

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

System.Data.Common

Сборки:

netstandard.dll, 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).