Udostępnij za pośrednictwem


RangeAttribute Klasa

Definicja

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.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
[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Property, AllowMultiple=false)>]
type RangeAttribute = class
    inherit ValidationAttribute
Public Class RangeAttribute
Inherits ValidationAttribute
Dziedziczenie
Atrybuty

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)

Jawne implementacje interfejsu

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

Zestaw nazw jest mapowany na odpowiedni zestaw identyfikatorów wysyłania.

(Odziedziczone po Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Pobiera informacje o typie obiektu, którego można użyć do pobrania informacji o typie interfejsu.

(Odziedziczone po Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Pobiera informację o liczbie typów interfejsów, jakie zawiera obiekt (0 lub 1).

(Odziedziczone po Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Umożliwia dostęp do właściwości i metod udostępnianych przez obiekt.

(Odziedziczone po Attribute)

Dotyczy