EditContext.ValidateAsync(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.
Valida isso EditContext de forma assíncrona.
Cancela qualquer tarefa de validação assíncrona no nível do campo pendente, invoca os manipuladores síncronos OnValidationRequested , invoca e aguarda os manipuladores assíncronos OnValidationRequestedAsync simultaneamente. Exceções de manipuladores síncronos se propagam para o chamador, correspondendo Validate(). Qualquer exceção sem cancelamento gerada por um manipulador assíncrono está contida: o formulário é marcado como com falha (observável por meio do parâmetro IsValidationFaulted()) e o método retorna false.
Enquanto a parte assíncrona está em pré-lançamento, o sem IsValidationPending() parâmetros retorna true para que os aplicativos possam mostrar uma "validação" global indicador sem encapsular a chamada em si. O resultado no nível IsValidationFaulted() do formulário é atualizado somente quando uma passagem é concluída; ela é preservada em passagens canceladas pelo chamador.
public System.Threading.Tasks.Task<bool> ValidateAsync(System.Threading.CancellationToken cancellationToken = default);member this.ValidateAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>Public Function ValidateAsync (Optional cancellationToken As CancellationToken = Nothing) As Task(Of Boolean)Parâmetros
- cancellationToken
- CancellationToken
Um token que sinaliza o cancelamento desse passe de validação. O token é exposto a manipuladores assíncronos por meio de CancellationToken. Se o chamador cancelar o token, esse método será gerado OperationCanceledException; o formulário não será marcado como com falha nesse caso e o estado de falha no nível do formulário anterior será preservado. O token limita apenas a passagem em voo; As tarefas de validação no nível do campo que começam independentemente durante a janela aguardada (por exemplo, de edições de usuário) não estão vinculadas a esse token e continuam em execução.
Retornos
True se não houver mensagens de validação após a validação e nenhum manipulador assíncrono falhou; caso contrário, false.
Exceções
Gerado quando cancellationToken é cancelado antes ou durante a aprovação de validação.
Comentários
A validação não deve ser inserida novamente. Não chamar Validate() ou ValidateAsync(CancellationToken) de dentro de um OnValidationRequested, OnValidationRequestedAsyncou OnValidationStateChanged manipulador anexado ao mesmo EditContext; fazer isso produz um comportamento indefinido.