Validator.ValidateObjectAsync 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.
Sobrecargas
| Nome | Description |
|---|---|
| ValidateObjectAsync(Object, ValidationContext, CancellationToken) |
Lança de forma assíncrona um ValidationException se o dado |
| ValidateObjectAsync(Object, ValidationContext, Boolean, CancellationToken) |
Gerará de forma assíncrona um ValidationException caso a instância de objeto fornecida não seja válida. |
ValidateObjectAsync(Object, ValidationContext, CancellationToken)
- Origem:
- Validator.cs
Lança de forma assíncrona um ValidationException se o dado instance não for válido.
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Constructing a ValidationContext without a display name is not trim-safe because it uses reflection to discover the type of the instance being validated in order to resolve the DisplayNameAttribute when a display name is not provided.")]
public static System.Threading.Tasks.Task ValidateObjectAsync(object instance, System.ComponentModel.DataAnnotations.ValidationContext validationContext, System.Threading.CancellationToken cancellationToken = default);[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Constructing a ValidationContext without a display name is not trim-safe because it uses reflection to discover the type of the instance being validated in order to resolve the DisplayNameAttribute when a display name is not provided.")>]
static member ValidateObjectAsync : obj * System.ComponentModel.DataAnnotations.ValidationContext * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function ValidateObjectAsync (instance As Object, validationContext As ValidationContext, Optional cancellationToken As CancellationToken = Nothing) As TaskParâmetros
- instance
- Object
A instância de objeto a ser testada. Não pode ser null.
- validationContext
- ValidationContext
Descreve o objeto que está sendo validado e fornece serviços e contexto para os validadores.
- cancellationToken
- CancellationToken
Um CancellationToken para observar enquanto aguarda a conclusão da tarefa.
Retornos
Um Task que representa a operação de validação assíncrona.
- Atributos
Exceções
Quando instance é null.
Quando validationContext é null.
Quando instance não corresponde ao ObjectInstance ativado validationContext.
Quando instance for considerado inválido.
A operação de validação foi cancelada.
Comentários
Esse método verifica os RequiredAttribute atributos nas propriedades do objeto. Se a validação da propriedade for bem-sucedida, o método avaliará os ValidationAttribute atributos anexados ao tipo do objeto.
Essa sobrecarga não avalia outros atributos de validação no nível da propriedade. Para avaliar esses atributos, chame a sobrecarga que aceita validateAllProperties com esse argumento definido como true.
A validação é executada em três estágios: validação de propriedade, validação de atributo no nível do tipo e validação no nível do objeto. Cada estágio será executado somente se os estágios anteriores forem bem-sucedidos. A validação no nível do objeto prefere invocar ValidateAsync(ValidationContext, CancellationToken) quando implementada, com Validate(ValidationContext) como um fallback para objetos que implementam apenas a interface síncrona. Ele não invoca ambos.
Aplica-se a
ValidateObjectAsync(Object, ValidationContext, Boolean, CancellationToken)
- Origem:
- Validator.cs
Gerará de forma assíncrona um ValidationException caso a instância de objeto fornecida não seja válida.
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Constructing a ValidationContext without a display name is not trim-safe because it uses reflection to discover the type of the instance being validated in order to resolve the DisplayNameAttribute when a display name is not provided.")]
public static System.Threading.Tasks.Task ValidateObjectAsync(object instance, System.ComponentModel.DataAnnotations.ValidationContext validationContext, bool validateAllProperties, System.Threading.CancellationToken cancellationToken = default);[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Constructing a ValidationContext without a display name is not trim-safe because it uses reflection to discover the type of the instance being validated in order to resolve the DisplayNameAttribute when a display name is not provided.")>]
static member ValidateObjectAsync : obj * System.ComponentModel.DataAnnotations.ValidationContext * bool * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function ValidateObjectAsync (instance As Object, validationContext As ValidationContext, validateAllProperties As Boolean, Optional cancellationToken As CancellationToken = Nothing) As TaskParâmetros
- instance
- Object
A instância de objeto a ser testada. Não pode ser null.
- validationContext
- ValidationContext
Descreve o objeto que está sendo validado e fornece serviços e contexto para os validadores.
- validateAllProperties
- Boolean
Se truetambém validar todas as instancepropriedades de 's.
- cancellationToken
- CancellationToken
Um CancellationToken para observar enquanto aguarda a conclusão da tarefa.
Retornos
Um Task que representa a operação de validação assíncrona.
- Atributos
Exceções
Quando instance é null.
Quando validationContext é null.
Quando instance não corresponde ao ObjectInstance ativado validationContext.
Quando instance for considerado inválido.
A operação de validação foi cancelada.
Comentários
Esse método verifica os RequiredAttribute atributos nas propriedades do objeto mesmo quando validateAllProperties é false. Se a validação da propriedade for bem-sucedida, o método avaliará os ValidationAttribute atributos anexados ao tipo do objeto.
Se validateAllProperties for true, o método também avaliará outros atributos de validação nas propriedades imediatas do objeto. Esse processo não valida recursivamente valores de propriedade.
A validação é executada em três estágios: validação de propriedade, validação de atributo no nível do tipo e validação no nível do objeto. Cada estágio será executado somente se os estágios anteriores forem bem-sucedidos. A validação no nível do objeto prefere invocar ValidateAsync(ValidationContext, CancellationToken) quando implementada, com Validate(ValidationContext) como um fallback para objetos que implementam apenas a interface síncrona. Ele não invoca ambos.
