Freigeben über

RequiredFieldValidator-Steuerelement

Evaluiert den Wert eines Eingabesteuerelements, um sicherzustellen, dass der Benutzer einen Wert eingegeben hat.

<asp:RequiredFieldValidatorid="ProgrammaticID"      ControlToValidate="ProgrammaticID of control to validate"      InitialValue="value"     ErrorMessage="Message to display in ValidationSummary control"     Text="Message to display in control"     ForeColor="value"      BackColor="value" ...      runat="server" ></asp:RequiredFieldValidator>

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 verä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   Zusätzliche Leerzeichen am Anfang und am Ende des Eingabewertes werden vor der Überprüfung 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 setzt nicht den Standardwert für das Eingabesteuerelement. 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 Bestätigungen zugeordnet werden. Beispielsweise kann mit RequiredFieldValidator sichergestellt werden, dass eine Eingabe im Steuerelement erfolgt, und gleichzeitig kann mit RangeValidator sichergestellt werden, dass die Eingabe im angegebenen Datenbereich liegt.

Weitere Informationen zum RequiredFieldValidator-Steuerelement finden Sie unter RequiredFieldValidator-Klasse.

Beispiel

Das folgende Beispiel veranschaulicht, wie Sie mit einem RequiredFieldValidator-Steuerelement ein TextBox-Steuerelement als erforderliches Feld festlegen können.

<html>
<body>

   <h3>RequiredFieldValidator Example</h3>

   <form runat="server">

      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"/>

   </form>

</body>
</html>

Siehe auch

RequiredFieldValidator-Klasse | Validierungsserversteuerelemente

  • Last updated on