RangeAttribute Klasse

Definition

Namespace:

System.ComponentModel.DataAnnotations

Assembly:

System.ComponentModel.Annotations.dll

Quelle:

RangeAttribute.cs

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.Parameter | System.AttributeTargets.Property, AllowMultiple=false)>]
type RangeAttribute = class
    inherit ValidationAttribute

Public Class RangeAttribute
Inherits ValidationAttribute

Vererbung

Object

Attribute

ValidationAttribute

RangeAttribute

Attribute

AttributeUsageAttribute

Beispiele

Das folgende Beispiel zeigt, wie Sie die RangeAttribute Formatierung für ein Datenfeld anpassen. Das Beispiel führt die folgenden Schritte aus:

• Implementiert eine partielle Metadatenklasse und die zugehörige Metadatenklasse.

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

  • Wenden Sie das Attribut auf ein Datenfeld vom Typ Integer an.

  • Wenden Sie das Attribut auf ein ganzzahliges Datenfeld an, und definieren Sie eine benutzerdefinierte Validierungsfehlermeldung.

  • 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. Dadurch 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 Validierungsattributen befolgen. Weitere Informationen finden Sie unter ASP.NET Richtlinien für dynamische Daten.

Konstruktoren

RangeAttribute(Double, Double)	Initialisiert eine neue Instanz der RangeAttribute-Klasse unter Verwendung der angegebenen Mindest- und Höchstwerte.
RangeAttribute(Int32, Int32)	Initialisiert eine neue Instanz der RangeAttribute-Klasse unter Verwendung der angegebenen Mindest- und Höchstwerte.
RangeAttribute(Type, String, String)	Initialisiert eine neue Instanz der RangeAttribute-Klasse unter Verwendung der angegebenen Mindest- und Höchstwerte und des angegebenen Typs.

Eigenschaften

ConvertValueInInvariantCulture	Ruft einen Wert ab, der bestimmt, ob alle Konvertierungen des Werts, auf den überprüft wird, OperandType als vom type Parameter des RangeAttribute(Type, String, String) Konstruktors festgelegt, die invariante Kultur oder die aktuelle Kultur verwenden, oder legt diesen fest.
ErrorMessage	Ruft eine Fehlermeldung ab, die beim Fehlschlagen der Validierung einem Validierungssteuerelement zugeordnet wird, oder legt diese fest. (Geerbt von ValidationAttribute)
ErrorMessageResourceName	Ruft den Fehlermeldungsressourcennamen ab, mithilfe dessen der ErrorMessageResourceType-Eigenschaftswert nachgeschlagen werden soll, wenn die Validierung fehlschlägt, oder legt diesen fest. (Geerbt von ValidationAttribute)
ErrorMessageResourceType	Ruft den Ressourcentyp ab, der für die Fehlermeldungssuche verwendet werden soll, wenn die Validierung fehlschlägt, oder legt ihn fest. (Geerbt von ValidationAttribute)
ErrorMessageString	Ruft die lokalisierte Validierungsfehlermeldung ab. (Geerbt von ValidationAttribute)
Maximum	Ruft den zulässigen Höchstwert für das Feld ab.
MaximumIsExclusive	Gibt an, ob bei der Überprüfung für Werte, die gleich sind, ein Fehler auftreten Maximumsoll.
Minimum	Ruft den zulässigen Mindestwert für das Feld ab.
MinimumIsExclusive	Gibt an, ob bei der Überprüfung für Werte, die gleich sind, ein Fehler auftreten Minimumsoll.
OperandType	Ruft den Typ des Datenfelds ab, dessen Wert überprüft werden soll.
ParseLimitsInInvariantCulture	Ruft einen Wert ab, der bestimmt, ob Zeichenfolgenwerte für Minimum und Maximum statt mit der aktuellen Kultur mit der invarianten Kultur analysiert werden, oder legt ihn fest.
RequiresValidationContext	Ruft einen Wert ab, der angibt, ob das Attribut Validierungskontext erfordert. (Geerbt von ValidationAttribute)
TypeId	Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab. (Geerbt von Attribute)

Methoden

Equals(Object)	Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist. (Geerbt von Attribute)
FormatErrorMessage(String)	Formatiert die Fehlermeldung, die angezeigt wird, wenn die Bereichsvalidierung fehlschlägt.
GetHashCode()	Gibt den Hashcode für diese Instanz zurück. (Geerbt von Attribute)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
GetValidationResult(Object, ValidationContext)	Überprüft, ob der angegebene Wert in Bezug auf das aktuelle Validierungsattribut gültig ist. (Geerbt von ValidationAttribute)
IsDefaultAttribute()	Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute)
IsValid(Object)	Überprüft, dass der Wert des Datenfelds im angegebenen Bereich liegt.
IsValid(Object, ValidationContext)	Überprüft den angegebenen Wert in Bezug auf das aktuelle Validierungsattribut. (Geerbt von ValidationAttribute)
Match(Object)	Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
Validate(Object, String)	Validiert das angegebene Objekt. (Geerbt von ValidationAttribute)
Validate(Object, ValidationContext)	Validiert das angegebene Objekt. (Geerbt von ValidationAttribute)