Partilhar via


DbConnection.BeginDbTransactionAsync Método

Definição

Inicia de maneira assíncrona uma transação de banco de dados.

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)

Parâmetros

isolationLevel
IsolationLevel

Um dos valores de enumeração que especifica o nível de isolamento a ser usado pela transação.

cancellationToken
CancellationToken

Um token para cancelar a operação assíncrona.

Retornos

Uma tarefa cuja propriedade Result é um objeto que representa a nova transação.

Exceções

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

Comentários

A implementação padrão desse método assíncrono delega ao seu equivalente síncrono e retorna um concluído Task, potencialmente bloqueando o thread de chamada.

Os provedores de dados que dão suporte à programação assíncrona devem substituir a implementação padrão usando operações de E/S assíncronas.

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por BeginDbTransaction(IsolationLevel).

Aplica-se a