RangeAttribute Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
DateTimeDatenfeld 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 |
| 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) |