Compartilhar via


DbConnection.BeginTransactionAsync Método

Definição

Sobrecargas

BeginTransactionAsync(CancellationToken)

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

BeginTransactionAsync(IsolationLevel, CancellationToken)

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

BeginTransactionAsync(CancellationToken)

Origem:
DbConnection.cs
Origem:
DbConnection.cs
Origem:
DbConnection.cs

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

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)

Parâmetros

cancellationToken
CancellationToken

Um token opcional para cancelar a operação assíncrona. O valor padrão é None.

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

Se você não especificar um nível de isolamento, o nível de isolamento padrão para o tipo específico de conexão será usado.

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 a contraparte síncrona 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 BeginTransaction().

Aplica-se a

BeginTransactionAsync(IsolationLevel, CancellationToken)

Origem:
DbConnection.cs
Origem:
DbConnection.cs
Origem:
DbConnection.cs

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

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)

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 opcional para cancelar a operação assíncrona. O valor padrão é None.

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 a contraparte síncrona 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 BeginTransaction(IsolationLevel).

Aplica-se a