RequiredAttribute Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Určuje, že je požadována hodnota datového pole.
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
- Dědičnost
- Atributy
Příklady
Následující příklad používá RequiredAttribute atribut k přepsání pravidla schématu databáze, které umožňuje, aby datové pole bylo prázdné. Příklad provede následující kroky:
Implementuje částečnou třídu metadat a přidruženou třídu metadat.
Ve třídě přidružených metadat použije RequiredAttribute atribut, který určuje následující požadavky:
Datové pole Název nemůže být prázdné. Pokud se ověření nezdaří, kód v příkladu vyvolá výjimku ověření a zobrazí chybovou zprávu. Chybová zpráva se zadává v době, kdy se atribut použije na datové pole.
Datové pole MiddleName nemůže být prázdné. Pokud se ověření nezdaří, kód v příkladu vyvolá výjimku ověření a zobrazí chybovou zprávu.
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
Poznámky
Atribut RequiredAttribute určuje, že pokud je pole ve formuláři ověřeno, musí pole obsahovat hodnotu. Výjimka ověření je vyvolána, pokud je nullvlastnost , obsahuje prázdný řetězec (""), nebo obsahuje pouze prázdné znaky.
Note
Pokud datový model MVC nebo částečná třída entity obsahuje pole, které je opatřeno poznámkami atributu RequiredAttribute , ale stránka neobsahuje vlastnost, vyvolá se chyba. K ověření dochází pouze u polí odeslaných na server.
Konstruktory
| Name | Description |
|---|---|
| RequiredAttribute() |
Inicializuje novou instanci RequiredAttribute třídy. |
Vlastnosti
| Name | Description |
|---|---|
| AllowEmptyStrings |
Získá nebo nastaví hodnotu, která označuje, zda je prázdný řetězec povolen. |
| ErrorMessage |
Získá nebo nastaví chybovou zprávu, která se přidruží k ověřovacímu ovládacímu prvku, pokud se ověření nezdaří. (Zděděno od ValidationAttribute) |
| ErrorMessageResourceName |
Získá nebo nastaví název prostředku chybové zprávy použít k vyhledání ErrorMessageResourceType hodnoty vlastnosti v případě selhání ověření. (Zděděno od ValidationAttribute) |
| ErrorMessageResourceType |
Získá nebo nastaví typ prostředku, který se má použít pro vyhledávání chybových zpráv, pokud se ověření nezdaří. (Zděděno od ValidationAttribute) |
| ErrorMessageString |
Získá lokalizovanou ověřovací chybovou zprávu. (Zděděno od ValidationAttribute) |
| RequiresValidationContext |
Získá hodnotu, která označuje, zda atribut vyžaduje kontext ověření. (Zděděno od ValidationAttribute) |
| TypeId |
Při implementaci v odvozené třídě získá jedinečný identifikátor pro tento Attribute. (Zděděno od Attribute) |
Metody
| Name | Description |
|---|---|
| Equals(Object) |
Vrátí hodnotu, která určuje, zda je tato instance rovna zadanému objektu. (Zděděno od Attribute) |
| FormatErrorMessage(String) |
Použije formátování na chybovou zprávu na základě datového pole, ve kterém došlo k chybě. (Zděděno od ValidationAttribute) |
| GetHashCode() |
Vrátí kód hash pro tuto instanci. (Zděděno od Attribute) |
| GetType() |
Získá Type aktuální instance. (Zděděno od Object) |
| GetValidationResult(Object, ValidationContext) |
Zkontroluje, zda je zadaná hodnota platná s ohledem na aktuální ověřovací atribut. (Zděděno od ValidationAttribute) |
| IsDefaultAttribute() |
Při přepsání v odvozené třídě určuje, zda hodnota této instance je výchozí hodnotou pro odvozenou třídu. (Zděděno od Attribute) |
| IsValid(Object, ValidationContext) |
Ověří zadanou hodnotu s ohledem na aktuální ověřovací atribut. (Zděděno od ValidationAttribute) |
| IsValid(Object) |
Zkontroluje, jestli hodnota požadovaného datového pole není prázdná. |
| Match(Object) |
Při přepsání v odvozené třídě vrátí hodnotu, která určuje, zda se tato instance rovná zadanému objektu. (Zděděno od Attribute) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object) |
| ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
| Validate(Object, String) |
Ověří zadaný objekt. (Zděděno od ValidationAttribute) |
| Validate(Object, ValidationContext) |
Ověří zadaný objekt. (Zděděno od ValidationAttribute) |
Explicitní implementace rozhraní
| Name | Description |
|---|---|
| _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Mapuje sadu názvů na odpovídající sadu identifikátorů pro rozesílání. (Zděděno od Attribute) |
| _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
Načte informace o typu objektu, který lze použít k získání informací o typu pro rozhraní. (Zděděno od Attribute) |
| _Attribute.GetTypeInfoCount(UInt32) |
Získá počet rozhraní typu informací, které objekt poskytuje (0 nebo 1). (Zděděno od Attribute) |
| _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Poskytuje přístup k vlastnostem a metodám vystaveným objektem. (Zděděno od Attribute) |