RangeAttribute Klasa

Definicja

Przestrzeń nazw:

System.ComponentModel.DataAnnotations

Zestaw:

System.ComponentModel.Annotations.dll

Źródło:

RangeAttribute.cs

Określa ograniczenia zakresu liczbowego dla wartości pola danych.

public ref class RangeAttribute : System::ComponentModel::DataAnnotations::ValidationAttribute

[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property, AllowMultiple=false)]
public class RangeAttribute : System.ComponentModel.DataAnnotations.ValidationAttribute

[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property, AllowMultiple=false)>]
type RangeAttribute = class
    inherit ValidationAttribute

Public Class RangeAttribute
Inherits ValidationAttribute

Dziedziczenie

Object

Attribute

ValidationAttribute

RangeAttribute

Atrybuty

AttributeUsageAttribute

Przykłady

W poniższym przykładzie pokazano, jak dostosować formatowanie pola danych przy użyciu RangeAttribute polecenia . Przykład wykonuje następujące kroki:

• Implementuje klasę częściową metadanych i skojarzoną klasę metadanych.

• W skojarzonej klasie metadanych stosuje RangeAttribute atrybut w celu uzyskania następujących wyników:

  • Zastosuj atrybut do pola danych typu liczba całkowita.

  • Zastosuj atrybut do pola danych całkowitych i zdefiniuj niestandardowy komunikat o błędzie walidacji.

  • Zastosuj atrybut do DateTime pola danych i zdefiniuj niestandardowy komunikat o błędzie walidacji.

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

[MetadataType(typeof(ProductMetaData))]
public partial class Product
{
}

public class ProductMetaData
{
    
    [Range(10, 1000, 
        ErrorMessage = "Value for {0} must be between {1} and {2}.")]
    public object Weight;

    [Range(300, 3000)]
    public object ListPrice;

    [Range(typeof(DateTime), "1/2/2004", "3/4/2004",
        ErrorMessage = "Value for {0} must be between {1} and {2}")]
    public object SellEndDate;
}

Imports System.Web.DynamicData
Imports System.ComponentModel.DataAnnotations
Imports System.ComponentModel

<MetadataType(GetType(ProductMetaData))> _
Partial Public Class Product

End Class


Public Class ProductMetaData
    
    <Range(10, 1000, _
           ErrorMessage:="Value for {0} must be between {1} and {2}.")> _
    Public Weight As Object

    <Range(300, 3000)> _
    Public ListPrice As Object

    <Range(GetType(DateTime), "1/2/2004", "3/4/2004", _
           ErrorMessage:="Value for {0} must be between {1} and {2}")> _
    Public SellEndDate As Object

End Class

Aby skompilować przykład, potrzebne są następujące elementy:

• Microsoft Visual Studio 2008 Service Pack 1 lub Visual Web Developer 2008 Express Edition SP1.

• Oparta na danych witryna sieci Web. Umożliwia to utworzenie kontekstu danych dla bazy danych i klasy zawierającej pole danych w celu dostosowania. Aby uzyskać więcej informacji, zobacz Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Uwagi

Po zastosowaniu tego atrybutu do pola danych należy postępować zgodnie z wytycznymi dotyczącymi używania atrybutów weryfikacji. Aby uzyskać więcej informacji, zobacz ASP.NET wskazówki dotyczące danych dynamicznych.

Konstruktory

RangeAttribute(Double, Double)	Inicjuje RangeAttribute nowe wystąpienie klasy przy użyciu określonych wartości minimalnych i maksymalnych.
RangeAttribute(Int32, Int32)	Inicjuje RangeAttribute nowe wystąpienie klasy przy użyciu określonych wartości minimalnych i maksymalnych.
RangeAttribute(Type, String, String)	Inicjuje RangeAttribute nowe wystąpienie klasy przy użyciu określonych wartości minimalnych i maksymalnych oraz określonego typu.

Właściwości

ConvertValueInInvariantCulture	Pobiera lub ustawia wartość określającą, czy wszelkie konwersje wartości zweryfikowanej jako OperandType ustawione przez type parametr RangeAttribute(Type, String, String) konstruktora używają niezmiennej kultury lub bieżącej kultury.
ErrorMessage	Pobiera lub ustawia komunikat o błędzie, który ma być skojarzony z kontrolką walidacji, jeśli walidacja nie powiedzie się. (Odziedziczone po ValidationAttribute)
ErrorMessageResourceName	Pobiera lub ustawia nazwę zasobu komunikatu o błędzie, która ma być używana w celu wyszukania ErrorMessageResourceType wartości właściwości w przypadku niepowodzenia walidacji. (Odziedziczone po ValidationAttribute)
ErrorMessageResourceType	Pobiera lub ustawia typ zasobu, który ma być używany do wyszukiwania komunikatów o błędzie, jeśli walidacja nie powiedzie się. (Odziedziczone po ValidationAttribute)
ErrorMessageString	Pobiera zlokalizowany komunikat o błędzie weryfikacji. (Odziedziczone po ValidationAttribute)
Maximum	Pobiera maksymalną dozwoloną wartość pola.
MaximumIsExclusive	Określa, czy walidacja powinna zakończyć się niepowodzeniem dla wartości, które są równe Maximum.
Minimum	Pobiera minimalną dozwoloną wartość pola.
MinimumIsExclusive	Określa, czy walidacja powinna zakończyć się niepowodzeniem dla wartości, które są równe Minimum.
OperandType	Pobiera typ pola danych, którego wartość musi zostać zweryfikowana.
ParseLimitsInInvariantCulture	Pobiera lub ustawia wartość określającą, czy wartości ciągów dla Minimum i Maximum są analizowane przy użyciu niezmiennej kultury, a nie bieżącej kultury.
RequiresValidationContext	Pobiera wartość wskazującą, czy atrybut wymaga kontekstu weryfikacji. (Odziedziczone po ValidationAttribute)
TypeId	Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego elementu Attribute. (Odziedziczone po Attribute)

Metody

Equals(Object)	Zwraca wartość wskazującą, czy to wystąpienie jest równe podanemu obiektowi. (Odziedziczone po Attribute)
FormatErrorMessage(String)	Formatuje komunikat o błędzie wyświetlany w przypadku niepowodzenia walidacji zakresu.
GetHashCode()	Zwraca wartość skrótu dla tego wystąpienia. (Odziedziczone po Attribute)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
GetValidationResult(Object, ValidationContext)	Sprawdza, czy określona wartość jest prawidłowa w odniesieniu do bieżącego atrybutu weryfikacji. (Odziedziczone po ValidationAttribute)
IsDefaultAttribute()	W przypadku zastąpienia w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną klasy pochodnej. (Odziedziczone po Attribute)
IsValid(Object)	Sprawdza, czy wartość pola danych znajduje się w określonym zakresie.
IsValid(Object, ValidationContext)	Weryfikuje określoną wartość w odniesieniu do bieżącego atrybutu walidacji. (Odziedziczone po ValidationAttribute)
Match(Object)	W przypadku zastąpienia w klasie pochodnej zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. (Odziedziczone po Attribute)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
Validate(Object, String)	Weryfikuje określony obiekt. (Odziedziczone po ValidationAttribute)
Validate(Object, ValidationContext)	Weryfikuje określony obiekt. (Odziedziczone po ValidationAttribute)