Freigeben über


RangeAttribute Klasse

Definition

Gibt die Einschränkungen des numerischen Bereichs für den Wert eines Datenfelds an.

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
Vererbung
Attribute

Beispiele

Das folgende Beispiel zeigt, wie Sie die Formatierung für ein Datenfeld mithilfe der RangeAttribute Formatierung anpassen. Im Beispiel werden die folgenden Schritte ausgeführt:

  • Implementiert eine partielle Metadatenklasse und die zugeordnete Metadatenklasse.

  • In der zugeordneten Metadatenklasse wendet sie das RangeAttribute Attribut an, um die folgenden Ergebnisse zu erhalten:

    • Anwenden des Attributs auf ein Datenfeld vom Typ "Ganze Zahl".

    • Wenden Sie das Attribut auf ein ganzzahliges Datenfeld an, und definieren Sie eine benutzerdefinierte Überprüfungsfehlermeldung.

    • Wenden Sie das Attribut auf ein DateTime Datenfeld an, und definieren Sie eine benutzerdefinierte Überprüfungsfehlermeldung.

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

Zum Kompilieren des Beispiels benötigen Sie Folgendes:

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

  • Eine datengesteuerte Website. Auf diese Weise können Sie einen Datenkontext für die Datenbank und die Klasse erstellen, die das anzupassende Datenfeld enthält. Weitere Informationen finden Sie unter Walkthrough: Creating a New Dynamic Data Web Site using Scaffolding.

Hinweise

Wenn Sie dieses Attribut auf ein Datenfeld anwenden, müssen Sie die Richtlinien für die Verwendung von Überprüfungsattributen befolgen.

Konstruktoren

Name Beschreibung
RangeAttribute(Double, Double)

Initialisiert eine neue Instanz der RangeAttribute Klasse mithilfe der angegebenen Mindest- und Höchstwerte.

RangeAttribute(Int32, Int32)

Initialisiert eine neue Instanz der RangeAttribute Klasse mithilfe der angegebenen Mindest- und Höchstwerte.

RangeAttribute(Type, String, String)

Initialisiert eine neue Instanz der RangeAttribute Klasse mithilfe der angegebenen Mindest- und Höchstwerte und des spezifischen Typs.

Eigenschaften

Name Beschreibung
ConvertValueInInvariantCulture

Dient zum Abrufen oder Festlegen eines Werts, der bestimmt, ob konvertierungen des zu überprüfenden OperandType Werts durch den type Parameter des RangeAttribute(Type, String, String) Konstruktors die invariante Kultur oder die aktuelle Kultur verwenden.

ErrorMessage

Dient zum Abrufen oder Festlegen einer Fehlermeldung, die einem Überprüfungssteuerelement zugeordnet werden soll, wenn die Überprüfung fehlschlägt.

(Geerbt von ValidationAttribute)
ErrorMessageResourceName

Ruft den Namen der Fehlermeldungsressource ab, die verwendet werden soll, um den Eigenschaftswert nachzuschlagen, wenn die ErrorMessageResourceType Überprüfung fehlschlägt, oder legt diesen fest.

(Geerbt von ValidationAttribute)
ErrorMessageResourceType

Ruft den Ressourcentyp ab, der für die Fehlermeldungssuche verwendet werden soll, wenn die Überprüfung fehlschlägt, oder legt diesen fest.

(Geerbt von ValidationAttribute)
ErrorMessageString

Ruft die lokalisierte Überprüfungsfehlermeldung ab.

(Geerbt von ValidationAttribute)
Maximum

Ruft den maximal zulässigen Feldwert ab.

MaximumIsExclusive

Gibt an, ob die Überprüfung für Werte fehlschlägt, die gleich sind Maximum.

Minimum

Ruft den minimal zulässigen Feldwert ab.

MinimumIsExclusive

Gibt an, ob die Überprüfung für Werte fehlschlägt, die gleich sind Minimum.

OperandType

Ruft den Typ des Datenfelds ab, dessen Wert überprüft werden muss.

ParseLimitsInInvariantCulture

Dient zum Abrufen oder Festlegen eines Werts, der bestimmt, ob Zeichenfolgenwerte für Minimum und Maximum werden mithilfe der invarianten Kultur anstelle der aktuellen Kultur analysiert.

RequiresValidationContext

Ruft einen Wert ab, der angibt, ob für das Attribut ein Überprüfungskontext erforderlich ist.

(Geerbt von ValidationAttribute)
TypeId

Wenn sie in einer abgeleiteten Klasse implementiert wird, wird ein eindeutiger Bezeichner für diese Attribute.

(Geerbt von Attribute)

Methoden

Name Beschreibung
Equals(Object)

Gibt einen Wert zurück, der angibt, ob diese Instanz einem angegebenen Objekt entspricht.

(Geerbt von Attribute)
FormatErrorMessage(String)

Formatiert die Fehlermeldung, die angezeigt wird, wenn die Bereichsüberprüfung fehlschlägt.

GetHashCode()

Gibt den Hashcode für diese Instanz zurück.

(Geerbt von Attribute)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
GetValidationResult(Object, ValidationContext)

Überprüft, ob der angegebene Wert im Hinblick auf das aktuelle Überprüfungsattribut gültig ist.

(Geerbt von ValidationAttribute)
IsDefaultAttribute()

Wenn sie in einer abgeleiteten Klasse überschrieben wird, gibt an, ob der Wert dieser Instanz der Standardwert für die abgeleitete Klasse ist.

(Geerbt von Attribute)
IsValid(Object, ValidationContext)

Überprüft den angegebenen Wert im Hinblick auf das aktuelle Überprüfungsattribut.

(Geerbt von ValidationAttribute)
IsValid(Object)

Überprüft, ob sich der Wert des Datenfelds im angegebenen Bereich befindet.

Match(Object)

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem angegebenen Objekt entspricht.

(Geerbt von Attribute)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
Validate(Object, String)

Überprüft das angegebene Objekt.

(Geerbt von ValidationAttribute)
Validate(Object, ValidationContext)

Überprüft das angegebene Objekt.

(Geerbt von ValidationAttribute)

Explizite Schnittstellenimplementierungen

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

Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu.

(Geerbt von Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Ruft die Typinformationen für ein Objekt ab, mit denen die Typinformationen für eine Schnittstelle abgerufen werden können.

(Geerbt von Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1).

(Geerbt von Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Bietet Zugriff auf Eigenschaften und Methoden, die von einem Objekt verfügbar gemacht werden.

(Geerbt von Attribute)

Gilt für: