Validator.TryValidatePropertyAsync 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.
Testa de forma assíncrona se o valor da propriedade fornecido é válido.
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("The Type of validationContext.ObjectType cannot be statically discovered.")]
public static System.Threading.Tasks.Task<bool> TryValidatePropertyAsync(object? value, System.ComponentModel.DataAnnotations.ValidationContext validationContext, System.Collections.Generic.ICollection<System.ComponentModel.DataAnnotations.ValidationResult>? validationResults, System.Threading.CancellationToken cancellationToken = default);
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("The Type of validationContext.ObjectType cannot be statically discovered.")>]
static member TryValidatePropertyAsync : obj * System.ComponentModel.DataAnnotations.ValidationContext * System.Collections.Generic.ICollection<System.ComponentModel.DataAnnotations.ValidationResult> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
Public Shared Function TryValidatePropertyAsync (value As Object, validationContext As ValidationContext, validationResults As ICollection(Of ValidationResult), Optional cancellationToken As CancellationToken = Nothing) As Task(Of Boolean)
Parâmetros
- value
- Object
O valor a ser testado.
- validationContext
- ValidationContext
Descreve o membro da propriedade para validar e fornece serviços e contexto para os validadores.
- validationResults
- ICollection<ValidationResult>
Uma coleção opcional que recebe falhas de validação como ValidationResult instâncias.
- cancellationToken
- CancellationToken
Um CancellationToken para observar enquanto aguarda a conclusão da tarefa.
Retornos
Um Task<TResult> valor que será true se o valor for válido, false se algum erro de validação for encontrado.
- Atributos
Exceções
validationContext é nullou MemberName está ou está null vazio.
MemberName não identifica uma propriedade pública válida, não indexador ou value não pode ser atribuída a essa propriedade.
A operação de validação foi cancelada.
Comentários
Esse método testa cada ValidationAttribute um associado à propriedade identificada por validationContext. Se validationResults não for nulo, esse método adicionará um ValidationResult a ele para cada falha de validação.
Se houver um RequiredAttribute encontrado na propriedade, ele será avaliado antes de todos os outros atributos de validação. Se o validador necessário falhar, a validação será interrompida, adicionando essa única falha à validationResults coleção quando aplicável e retornando false.
Todas AsyncValidationAttribute as instâncias são avaliadas de forma assíncrona após todos os atributos de validação síncrona terem passado.