RequiredAttribute Classe

Definição

Especifica que um valor de campo de dados é necessário.

public ref class RequiredAttribute : System::ComponentModel::DataAnnotations::ValidationAttribute
[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property, AllowMultiple=false)]
public class RequiredAttribute : System.ComponentModel.DataAnnotations.ValidationAttribute
[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Property, AllowMultiple=false)]
public class RequiredAttribute : System.ComponentModel.DataAnnotations.ValidationAttribute
[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property, AllowMultiple=false)>]
type RequiredAttribute = class
    inherit ValidationAttribute
[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Property, AllowMultiple=false)>]
type RequiredAttribute = class
    inherit ValidationAttribute
Public Class RequiredAttribute
Inherits ValidationAttribute
Herança
Atributos

Exemplos

O exemplo a seguir usa o RequiredAttribute atributo para substituir a regra de esquema de banco de dados que permite que um campo de dados fique vazio. O exemplo executa as seguintes etapas:

  • Implementa uma classe parcial de metadados e a classe de metadados associada.

  • Na classe de metadados associada, ela aplica o RequiredAttribute atributo, que especifica os seguintes requisitos:

    • O campo de dados Título não pode estar vazio. Se a validação falhar, o código no exemplo gerará uma exceção de validação e exibirá uma mensagem de erro. A mensagem de erro é especificada no momento em que o atributo é aplicado ao campo de dados.

    • O campo de dados MiddleName não pode estar vazio. Se a validação falhar, o código no exemplo gerará uma exceção de validação e exibirá uma mensagem de erro.

using System;
using System.Web.DynamicData;
using System.ComponentModel.DataAnnotations;
using System.Globalization;

[MetadataType(typeof(CustomerMetaData))]
public partial class Customer
{
}

public class CustomerMetaData
{
    // Require that the Title is not null.
    // Use custom validation error.
    [Required(ErrorMessage = "Title is required.")]
    public object Title;
    
    // Require that the MiddleName is not null.
    // Use standard validation error.
    [Required()]
    public object MiddleName;
}
Imports System.Web.DynamicData
Imports System.ComponentModel.DataAnnotations
Imports System.Globalization

<MetadataType(GetType(CustomerMetaData))> _
Partial Public Class Customer

   
End Class

Public Class CustomerMetaData
    ' Require that the Title is not null.
    ' Use custom validation error.
    <Required(ErrorMessage:="Title is required.")> _
    Public Title As Object

    ' Require that the MiddleName is not null.
    ' Use standard validation error.
    <Required()> _
    Public MiddleName As Object

End Class

Comentários

O RequiredAttribute atributo especifica que, quando um campo em um formulário é validado, o campo deve conter um valor. Uma exceção de validação será gerada se a propriedade for null, contiver uma cadeia de caracteres vazia (") ou conter apenas caracteres de espaço em branco.

Observação

Se o modelo de dados MVC ou a classe parcial de entidade contiver um campo anotado com o RequiredAttribute atributo, mas a página não contiver a propriedade, um erro não será gerado. A validação ocorre apenas para campos que são enviados ao servidor.

Construtores

Nome Description
RequiredAttribute()

Inicializa uma nova instância da classe RequiredAttribute.

Propriedades

Nome Description
AllowEmptyStrings

Obtém ou define um valor que indica se uma cadeia de caracteres vazia é permitida.

ErrorMessage

Obtém ou define uma mensagem de erro a ser associada a um controle de validação se a validação falhar.

(Herdado de ValidationAttribute)
ErrorMessageResourceName

Obtém ou define o nome do recurso de mensagem de erro a ser usado para pesquisar o valor da ErrorMessageResourceType propriedade se a validação falhar.

(Herdado de ValidationAttribute)
ErrorMessageResourceType

Obtém ou define o tipo de recurso a ser usado para pesquisa de mensagem de erro se a validação falhar.

(Herdado de ValidationAttribute)
ErrorMessageString

Obtém a mensagem de erro de validação localizada.

(Herdado de ValidationAttribute)
RequiresValidationContext

Obtém um valor que indica se o atributo requer contexto de validação.

(Herdado de ValidationAttribute)
TypeId

Quando implementado em uma classe derivada, obtém um identificador exclusivo para esse Attribute.

(Herdado de Attribute)

Métodos

Nome Description
Equals(Object)

Retorna um valor que indica se essa instância é igual a um objeto especificado.

(Herdado de Attribute)
FormatErrorMessage(String)

Aplica a formatação a uma mensagem de erro, com base no campo de dados em que o erro ocorreu.

(Herdado de ValidationAttribute)
GetHashCode()

Retorna o código hash dessa instância.

(Herdado de Attribute)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
GetValidationResult(Object, ValidationContext)

Verifica se o valor especificado é válido em relação ao atributo de validação atual.

(Herdado de ValidationAttribute)
IsDefaultAttribute()

Quando substituído em uma classe derivada, indica se o valor dessa instância é o valor padrão para a classe derivada.

(Herdado de Attribute)
IsValid(Object, ValidationContext)

Valida o valor especificado em relação ao atributo de validação atual.

(Herdado de ValidationAttribute)
IsValid(Object)

Verifica se o valor do campo de dados necessário não está vazio.

Match(Object)

Quando substituído em uma classe derivada, retorna um valor que indica se essa instância é igual a um objeto especificado.

(Herdado de Attribute)
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)
Validate(Object, String)

Valida o objeto especificado.

(Herdado de ValidationAttribute)
Validate(Object, ValidationContext)

Valida o objeto especificado.

(Herdado de ValidationAttribute)

Implantações explícitas de interface

Nome Description
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Mapeia um conjunto de nomes para um conjunto correspondente de identificadores de expedição.

(Herdado de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Recupera as informações de tipo de um objeto, que podem ser usadas para obter as informações de tipo de uma interface.

(Herdado de Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Retorna o número de interfaces de informações do tipo que um objeto fornece (0 ou 1).

(Herdado de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fornece acesso a propriedades e métodos expostos por um objeto.

(Herdado de Attribute)

Aplica-se a