DbConnection.BeginTransactionAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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).
