DbConnection.BeginTransactionAsync Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Sobrecargas
| Name | Description |
|---|---|
| BeginTransactionAsync(CancellationToken) |
Inicia de forma assíncrona uma transação na base de dados. |
| BeginTransactionAsync(IsolationLevel, CancellationToken) |
Inicia de forma assíncrona uma transação na base de dados. |
BeginTransactionAsync(CancellationToken)
Inicia de forma assíncrona uma transação na base 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 predefinido é None.
Devoluções
Uma tarefa cuja Result propriedade é um objeto que representa a nova transação.
Exceções
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Se não especificar um nível de isolamento, é usado o nível de isolamento padrão para o tipo específico de ligação.
A implementação padrão deste método assíncrono delega ao seu equivalente síncrono e devolve um completo Task, potencialmente bloqueando o thread que chama.
Os fornecedores de dados que suportam programação assíncrona devem sobrepor a implementação padrão usando operações de I/O assíncronas.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por BeginTransaction().
Aplica-se a
BeginTransactionAsync(IsolationLevel, CancellationToken)
Inicia de forma assíncrona uma transação na base 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 para a transação utilizar.
- cancellationToken
- CancellationToken
Um token opcional para cancelar a operação assíncrona. O valor predefinido é None.
Devoluções
Uma tarefa cuja Result propriedade é um objeto que representa a nova transação.
Exceções
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
A implementação padrão deste método assíncrono delega ao seu equivalente síncrono e devolve um completo Task, potencialmente bloqueando o thread que chama.
Os fornecedores de dados que suportam programação assíncrona devem sobrepor a implementação padrão usando operações de I/O assíncronas.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por BeginTransaction(IsolationLevel).