AsyncValidationAttribute.GetValidationResultAsync 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.
Testa se o dado value é válido de forma assíncrona em relação ao atributo de validação atual sem lançar um ValidationException.
public System.Threading.Tasks.Task<System.ComponentModel.DataAnnotations.ValidationResult?> GetValidationResultAsync(object? value, System.ComponentModel.DataAnnotations.ValidationContext validationContext, System.Threading.CancellationToken cancellationToken = default);member this.GetValidationResultAsync : obj * System.ComponentModel.DataAnnotations.ValidationContext * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.ComponentModel.DataAnnotations.ValidationResult>Public Function GetValidationResultAsync (value As Object, validationContext As ValidationContext, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ValidationResult)Parâmetros
- value
- Object
O valor a validar.
- validationContext
- ValidationContext
Uma ValidationContext instância que forneça contexto sobre a operação de validação, como o objeto e o membro a serem validados. Fornece acesso aos serviços necessários para realizar validação usando IServiceProvider.
- cancellationToken
- CancellationToken
A CancellationToken para observar enquanto se espera que a tarefa seja concluída.
Devoluções
A Task<TResult> representa a operação de validação assíncrona.
Quando a validação é válida, o resultado é Success.
Quando a validação é inválida, o resultado é uma instância de ValidationResult.
Exceções
O atributo atual está malformado.
Quando validationContext é null.
A operação de validação foi cancelada.
Observações
A implementação subjacente IsValidAsync(Object, ValidationContext, CancellationToken) deve observar o trabalho fornecido cancellationToken e parar o trabalho rapidamente quando for solicitado o cancelamento. A infraestrutura de validação aguarda todas as tarefas de validação iniciadas antes de regressar, por isso uma implementação que ignora o cancelamento pode atrasar falhas e curtos-circuitos.
Os chamadores que precisam de limitar o tempo de validação devem passar um token configurado para cancelar após um timeout, como um de um CancellationTokenSource token configurado com CancelAfter(TimeSpan).
