StringLengthAttribute Klasse

Definition

Namespace:

System.ComponentModel.DataAnnotations

Assembly:

System.ComponentModel.DataAnnotations.dll

Gibt die minimale und maximale Länge von Zeichen an, die in einem Datenfeld zulässig sind.

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

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

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

Public Class StringLengthAttribute
Inherits ValidationAttribute

Vererbung

Object

Attribute

ValidationAttribute

StringLengthAttribute

Attribute

AttributeUsageAttribute

Beispiele

Das folgende Beispiel zeigt, wie die Anzahl von Zeichen in einem Feld begrenzt wird. Dieses Beispiel funktioniert mit dem ThumbnailPhotoFileName-Feld in der Tabelle "Produkte" in der AdventureWorksLT-Datenbank. Das Feld ist auf 4 Zeichen beschränkt, indem das StringLengthAttribute Attribut auf die partielle Klasse angewendet wird, die die Product-Entität darstellt.

[MetadataType(typeof(ProductMetadata))]
public partial class Product
{

}

public class ProductMetadata
{

    [ScaffoldColumn(true)]
    [StringLength(4, ErrorMessage = "The ThumbnailPhotoFileName value cannot exceed 4 characters. ")]
    public object ThumbnailPhotoFileName;

    [ScaffoldColumn(true)]
    [StringLength(4, ErrorMessage = "The {0} value cannot exceed {1} characters. ")]
    public object PhotoFileName;

}

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

End Class

Public Class ProductMetadata

    <ScaffoldColumn(True)> _
    <StringLength(4, ErrorMessage := "The ThumbnailPhotoFileName value cannot exceed 4 characters. ")> _
    Public ThumbnailPhotoFileName As Object

    <ScaffoldColumn(True)> _
    <StringLength(4, ErrorMessage := "The {0} value cannot exceed {1} characters. ")> _
    Public PhotoFileName As Object

End Class

Hinweise

ASP.NET Dynamische Daten ermöglichen CRUD-Vorgänge (Erstellen, Lesen, Aktualisieren und Löschen) in einem Datenmodell. Sie können die minimale und maximale Länge von Zeichen für jedes Feld angeben, wenn Daten eingefügt oder aktualisiert werden. Bei Zeichendatentypen identifizieren die MinimumLength eigenschaften MaximumLength die größte Anzahl von Bytes, die erforderlich sind, um eine Zeichenfolge zu speichern.

Sie können Platzhalter für zusammengesetzte Formatierungen in der Fehlermeldung verwenden: {0} ist der Name der Eigenschaft, {1} die maximale Länge und {2} die Mindestlänge. Die Platzhalter entsprechen Argumenten, die zur Laufzeit an die String.Format Methode übergeben werden.

Konstruktoren

Name	Beschreibung
StringLengthAttribute(Int32)	Initialisiert eine neue Instanz der StringLengthAttribute Klasse mithilfe einer angegebenen maximalen Länge.

Eigenschaften

Name	Beschreibung
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)
MaximumLength	Ruft die maximale Länge einer Zeichenfolge ab oder legt sie fest.
MinimumLength	Ruft die Mindestlänge einer Zeichenfolge ab oder legt sie fest.
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)	Wendet die Formatierung auf eine angegebene Fehlermeldung an.
GetHashCode()	Gibt den Hashcode für diesen instance 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)	Bestimmt, ob ein angegebenes Objekt gültig ist.
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)