DbCommand.PrepareAsync(CancellationToken) 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.
Cria de forma assíncrona uma versão preparada (ou compilada) do comando na fonte de dados.
public virtual System.Threading.Tasks.Task PrepareAsync(System.Threading.CancellationToken cancellationToken = default);abstract member PrepareAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.PrepareAsync : System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Overridable Function PrepareAsync (Optional cancellationToken As CancellationToken = Nothing) As TaskParâmetros
- cancellationToken
- CancellationToken
Um token opcional para cancelar a operação assíncrona. O valor padrão é None.
Retornos
Um Task que representa a operação assíncrona.
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 thread de chamada 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.
Se a CommandType propriedade estiver definida como TableDirect, PrepareAsync não fará nada. Se CommandType estiver definido como StoredProcedure, a chamada deve PrepareAsync ser bem-sucedida, embora possa resultar em um no-op.
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 Prepare().
