RequiredFieldValidator-Steuerelement (Allgemeine Referenz)
[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]
Evaluiert den Wert eines Eingabesteuerelements, um sicherzustellen, dass der Benutzer einen Wert eingegeben hat.
<asp:RequiredFieldValidator
AccessKey="string"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
ControlToValidate="string"
CssClass="string"
Display="None|Static|Dynamic"
EnableClientScript="True|False"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
ErrorMessage="string"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
ID="string"
InitialValue="string"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
runat="server"
SetFocusOnError="True|False"
SkinID="string"
Style="string"
TabIndex="integer"
Text="string"
ToolTip="string"
ValidationGroup="string"
Visible="True|False"
Width="size"
/>
Hinweise
Mit dem RequiredFieldValidator-Steuerelement können Sie ein Eingabesteuerelement als erforderliches Feld festlegen. Das Eingabesteuerelement besteht die Validierung nicht, wenn der darin enthaltene Wert sich bei der Durchführung der Validierung gegenüber dem Anfangswert nicht ändert. Dadurch wird verhindert, dass der Benutzer das zugehörige Eingabesteuerelement unverändert lässt. Standardmäßig ist der Anfangswert eine leere Zeichenfolge (""). Dies weist darauf hin, dass in dem Eingabesteuerelement ein Wert eingegeben werden muss, damit dieses Element die Validierung besteht.
Hinweis
Vor der Validierung werden zusätzliche Leerzeichen am Anfang und am Ende des Eingabewerts entfernt.Dadurch wird verhindert, dass bei der Validierung ein Leerzeichen in das Eingabesteuerelement eingefügt wird.
In bestimmten Situationen benötigen Sie vielleicht einen Anfangswert, der keine leere Zeichenfolge ist. Dies ist sinnvoll, wenn Sie für ein Eingabesteuerelement einen Standardwert verwenden und der Benutzer einen anderen Wert auswählen soll. Sie können beispielsweise ein ListBox-Steuerelement verwenden, bei dem standardmäßig ein Eintrag ausgewählt ist und das den Benutzer anweist, ein Element aus der Liste auszuwählen. Der Benutzer muss ein Element aus dem Steuerelement auswählen, allerdings soll er nicht das Element auswählen, das die Anweisungen enthält. Sie können verhindern, dass der Benutzer dieses Element auswählt, indem Sie dessen Wert als den Anfangswert festlegen. Wenn der Benutzer dieses Element auswählt, zeigt das RequiredFieldValidator-Steuerelement seine Fehlermeldung an. Um den Anfangswert des zugehörigen Eingabesteuerelements anzugeben, legen Sie die InitialValue-Eigenschaft fest.
Hinweis
Die InitialValue-Eigenschaft legt nicht den Standardwert für das Eingabesteuerelement fest.Die InitialValue-Eigenschaft muss auch nicht mit dem Standardwert für das Eingabesteuerelement übereinstimmen.Sie gibt lediglich den Wert an, den der Benutzer nicht in dem Eingabesteuerelement eingeben soll.Das Eingabesteuerelement besteht die Validierung nicht, wenn es während der Ausführung der Validierung diesen Wert enthält.
Einem Eingabesteuerelement können mehrere Validierungssteuerelemente zugeordnet werden. Beispielsweise kann durch die Verwendung eines RequiredFieldValidator-Steuerelements sichergestellt werden, dass eine Eingabe im Steuerelement erfolgt, und gleichzeitig kann durch die Verwendung eines RangeValidator-Steuerelements sichergestellt werden, dass die Eingabe im angegebenen Datenbereich liegt.
Weitere Informationen über das RequiredFieldValidator-Steuerelement finden Sie in den Erläuterungen zur RequiredFieldValidator-Klasse.
Beispiel
Das folgende Beispiel veranschaulicht, wie Sie mit dem RequiredFieldValidator-Steuerelement ein TextBox-Steuerelement als erforderliches Feld festlegen können.
.gif "Sicherheitshinweis") Sicherheitshinweis |
|---|
In diesem Beispiel ist ein Textfeld für eine Benutzereingabe enthalten. Dies stellt ein potenzielles Sicherheitsrisiko dar.Standardmäßig stellt die ASP.NET-Seite sicher, dass die Benutzereingabe keine Skript- oder HTML-Elemente enthält.Weitere Informationen finden Sie unter Script Exploits Overview. |
Name:
<asp:TextBox id="Text1"
Text="Enter a value"
runat="server"/>
<asp:RequiredFieldValidator id="RequiredFieldValidator1"
ControlToValidate="Text1"
Text="Required Field!"
runat="server"/>
<p />
<asp:Button id="Button1"
runat="server"
Text="Validate"/>
Name:
<asp:TextBox id="Text1"
Text="Enter a value"
runat="server"/>
<asp:RequiredFieldValidator id="RequiredFieldValidator1"
ControlToValidate="Text1"
Text="Required Field!"
runat="server"/>
<p />
<asp:Button id="Button1"
runat="server"
Text="Validate"/>