Freigeben über

RegularExpressionValidator-Steuerelement

Evaluiert den Wert eines Eingabesteuerelements, um festzustellen, ob er einem Muster entspricht, das in einem regulären Ausdruck definiert ist.

<asp:RegularExpressionValidator 
     id="ProgrammaticID" 
     ControlToValidate="ProgrammaticID of control to validate" 
     ValidationExpression="expression" 
     ErrorMessage="Message to display in ValidationSummary control"
     Text="Message to display in control"
     ForeColor="value" 
     BackColor="value" ... 
     runat="server" >
</asp: RegularExpressionValidator>

Hinweise

Das RegularExpressionValidator-Steuerelement stellt fest, ob der Wert eines Eingabesteuerelements einem Muster entspricht, das durch einen regulären Ausdruck definiert wird. Mit dieser Art der Validierung können Sie eine Prüfung auf zu erwartende Zeichenfolgen durchführen, z. B. Zeichenfolgen in Sozialversicherungsnummern, E-Mail-Adressen, Telefonnummern, Postleitzahlen usw.

Hinweis   Wenn das Eingabesteuerelement leer ist, werden keine Validierungsfunktionen aufgerufen, und die Validierung wird erfolgreich durchgeführt. Verwenden Sie ein RequiredFieldValidator-Steuerelement, um zu verhindern, dass der Benutzer ein Eingabesteuerelement überspringt.

Sofern der Browser die clientseitige Validierung unterstützt oder diese nicht explizit deaktiviert ist (d. h. die EnableClientScript-Eigenschaft der Seite auf false festgelegt ist), werden sowohl die serverseitige als auch die clientseitige Validierung durchgeführt.

Mit Hilfe der ValidationExpression-Eigenschaft wird der reguläre Ausdruck angegeben, mit dem das Eingabesteuerelement validiert wird. Die Syntax für die Validierung regulärer Ausdrücke weist zwischen Client und Server kleinere Unterschiede auf. Auf dem Client wird die JScript-Syntax für reguläre Ausdrücke verwendet. Auf dem Server wird die Regex-Syntax verwendet. Da die JScript-Syntax für reguläre Ausdrücke eine Teilmenge der Regex-Syntax ist, wird bei regulären Ausdrücken die Verwendung der JScript-Syntax empfohlen, um auf dem Client und dem Server dieselben Ergebnisse zu erzielen.

Weitere Informationen zum Erstellen und Formatieren von regulären Ausdrücken finden Sie unter Reguläre Ausdrücke.

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

Beispiel

Das folgende Beispiel veranschaulicht, wie Sie mit dem RegularExpressionValidator-Steuerelement den in einem Textfeld eingegebenen Wert auf ein bestimmtes Muster hin überprüfen. Im aktuellen Beispiel ist dieses Muster eine fünfstellige Postleitzahl. Das Ergebnis der Validierung wird anschließend auf der Seite ausgegeben.

<%@ Page Language="VB" AutoEventWireup="True" %>

 <html>
 <head>
    <script runat="server">
 
       Sub ValidateBtn_Click(sender As Object, e As EventArgs) 
       
          If Page.IsValid Then 
          
             lblOutput.Text = "Page is Valid!"
          
          Else 
          
             lblOutput.Text = "Page is InValid!"
  
          End If

       End Sub
 
    </script>
 
 </head>
 <body>
 
    <h3>RegularExpressionValidator Sample</h3>
    <p>
 
    <form runat="server">
 
       <table bgcolor="#eeeeee" cellpadding="10">
          <tr valign="top">
             <td colspan="3">
                <asp:Label id="lblOutput" 
                     Text="Enter a 5 digit zip code" 
                     Font-Name="Verdana" 
                     Font-Size="10pt" 
                     runat="server"/>
             </td>
          </tr>
 
          <tr>
             <td colspan="3">
                <font <b>Personal Information</b>
             </td>
          </tr>
          <tr>
             <td align="right">
                Zip Code:
             </td>
             <td>
                <asp:TextBox id="TextBox1" 
                     runat="server"/>
             </td>
             <td>
                <asp:RegularExpressionValidator id="RegularExpressionValidator1" 
                     ControlToValidate="TextBox1"
                     ValidationExpression="\d{5}"
                     Display="Static"
                     EnableClientScript="false"
                     ErrorMessage="Zip code must be 5 numeric digits"
                     runat="server"/>
             </td>
          </tr>
          <tr>
             <td></td>
             <td>
                <asp:Button text="Validate" 
                     OnClick="ValidateBtn_Click" 
                     runat="server"/>
             </td>
             <td></td>
          </tr>
       </table>
 
    </form>
 
 </body>
 </html>
[C#]
<%@ Page Language="C#" AutoEventWireup="True" %>

 <html>
 <head>
    <script runat="server">
 
       void ValidateBtn_Click(Object sender, EventArgs e) 
       {
          if (Page.IsValid) 
          {
             lblOutput.Text = "Page is Valid!";
          }
          else 
          {
             lblOutput.Text = "Page is InValid!";
          }
       }
 
    </script>
 
 </head>
 <body>
 
    <h3>RegularExpressionValidator Sample</h3>
    <p>
 
    <form runat="server">
 
       <table bgcolor="#eeeeee" cellpadding="10">
          <tr valign="top">
             <td colspan="3">
                <asp:Label id="lblOutput" 
                     Text="Enter a 5 digit zip code" 
                     Font-Name="Verdana" 
                     Font-Size="10pt" 
                     runat="server"/>
             </td>
          </tr>
 
          <tr>
             <td colspan="3">
                <font <b>Personal Information</b>
             </td>
          </tr>
          <tr>
             <td align="right">
                Zip Code:
             </td>
             <td>
                <asp:TextBox id="TextBox1" 
                     runat="server"/>
             </td>
             <td>
                <asp:RegularExpressionValidator id="RegularExpressionValidator1" 
                     ControlToValidate="TextBox1"
                     ValidationExpression="\d{5}"
                     Display="Static"
                     EnableClientScript="false"
                     ErrorMessage="Zip code must be 5 numeric digits"
                     runat="server"/>
             </td>
          </tr>
          <tr>
             <td></td>
             <td>
                <asp:Button text="Validate" 
                     OnClick="ValidateBtn_Click" 
                     runat="server"/>
             </td>
             <td></td>
          </tr>
       </table>
 
    </form>
 
 </body>
 </html>

Siehe auch

RegularExpressionValidator-Klasse | Validierungsserversteuerelemente | Reguläre Ausdrücke

  • Last updated on