DbBatch.ExecuteNonQueryAsync(CancellationToken) 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.
Esta é a versão assíncrona de ExecuteNonQuery(). Os prestadores devem sobrepor-se com uma implementação adequada. O token de cancelamento pode, opcionalmente, ser ignorado.
A implementação padrão invoca o método síncrono ExecuteNonQuery() e devolve uma tarefa concluída, bloqueando a thread que chama. A implementação por defeito devolverá uma tarefa cancelada se for recebida um token de cancelamento já cancelado. As exceções lançadas por ExecuteNonQuery() serão comunicadas através da propriedade de Exceção de Tarefa devolvida.
Não invoque outros métodos e propriedades do DbCommand objeto até que a tarefa devolvida esteja concluída.
public abstract System.Threading.Tasks.Task<int> ExecuteNonQueryAsync(System.Threading.CancellationToken cancellationToken = default);abstract member ExecuteNonQueryAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>Public MustOverride Function ExecuteNonQueryAsync (Optional cancellationToken As CancellationToken = Nothing) As Task(Of Integer)Parâmetros
- cancellationToken
- CancellationToken
Um token para cancelar a operação assíncrona.
Devoluções
Uma tarefa que representa a operação assíncrona.
Exceções
Ocorreu um erro durante a execução do lote.
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Para mais informações sobre programação assíncrona, veja Programação Assíncrona.
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 ExecuteNonQuery().
