Freigeben über


RegularExpressionValidator-Klasse

Überprüft, ob der Wert eines verknüpften Eingabesteuerelements dem Muster entspricht, das in einem regulären Ausdruck angegeben ist.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Class RegularExpressionValidator
    Inherits BaseValidator
'Usage
Dim instance As RegularExpressionValidator
public class RegularExpressionValidator : BaseValidator
public ref class RegularExpressionValidator : public BaseValidator
public class RegularExpressionValidator extends BaseValidator
public class RegularExpressionValidator extends BaseValidator

Hinweise

Das RegularExpressionValidator-Steuerelement prüft, ob der Wert eines Eingabesteuerelements einem Muster entspricht, das in einem regulären Ausdruck definiert ist. Mit dieser Art von Validierung können Sie feststellen, ob vorhersehbare Zeichenfolgen vorhanden sind, z. B. Zeichenfolgen in E-Mail-Adressen, Telefonnummern und Postleitzahlen.

Hinweis

Die Validierung ist erfolgreich, wenn das Eingabesteuerelement leer ist. Wenn für das verknüpfte Eingabesteuerelement ein Wert erforderlich ist, verwenden Sie zusätzlich zum RegularExpressionValidator-Steuerelement ein RequiredFieldValidator-Steuerelement.

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

Die Implementierung der Validierung für reguläre Ausdrücke weist kleinere Unterschiede beim Client und beim Server auf. Auf dem Client wird die JScript-Syntax für reguläre Ausdrücke verwendet. Auf dem Server wird die System.Text.RegularExpressions.Regex-Syntax verwendet. Da die JScript-Syntax für reguläre Ausdrücke eine Teilmenge der System.Text.RegularExpressions.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 über Validierungssteuerelemente finden Sie unter BaseValidator. Weitere Informationen zu regulären Ausdrücken finden Sie unter Reguläre Ausdrücke von .NET Framework.

Eingabehilfen

Das für dieses Steuerelement standardmäßig wiedergegebene Markup entspricht eventuell nicht den Standards für die Eingabehilfen wie beispielsweise den Richtlinien der Web Content Accessibility Guidelines 1.0 (WCAG) mit der Priorität 1. Details über die Unterstützung von Eingabehilfen für dieses Steuerelement finden Sie unter Steuerelemente und Eingabehilfen von ASP.NET.

Thema Position
Exemplarische Vorgehensweise: Validieren der Benutzereingabe in einer Web Forms-Seite Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Validieren der Benutzereingabe in einer Web Forms-Seite Erstellen von Anwendungen mit Visual Web Developer
Gewusst wie: Validierung anhand von Werten in einer Datenbank für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Validierung anhand eines Wertebereichs für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Validierung anhand eines bestimmten Werts für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Validierung anhand eines Datentyps für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Validierung erforderlicher Einträge für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Anzeigen von benutzerdefinierten Validierungsmeldungen des Servers für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Programmgesteuertes Testen der Validierung für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Validierung anhand von Mustern für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Formatieren von Validierungsfehlermeldungen für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Validierung mit einer benutzerdefinierten Funktion für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Deaktivieren der Validierung für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Validierung anhand von Werten in einer Datenbank für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Validierung anhand eines Wertebereichs für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Validierung anhand eines bestimmten Werts für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Validierung anhand eines Datentyps für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Validierung erforderlicher Einträge für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Anzeigen von benutzerdefinierten Validierungsmeldungen des Servers für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Programmgesteuertes Testen der Validierung für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Validierung anhand von Mustern für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Formatieren von Validierungsfehlermeldungen für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Validierung mit einer benutzerdefinierten Funktion für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Deaktivieren der Validierung für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Validierung anhand von Werten in einer Datenbank für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Validierung anhand eines Wertebereichs für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Validierung anhand eines bestimmten Werts für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Validierung anhand eines Datentyps für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Validierung erforderlicher Einträge für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Anzeigen von benutzerdefinierten Validierungsmeldungen des Servers für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Programmgesteuertes Testen der Validierung für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Validierung anhand von Mustern für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Formatieren von Validierungsfehlermeldungen für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Validierung mit einer benutzerdefinierten Funktion für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Deaktivieren der Validierung für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen

Beispiel

Das folgende Beispiel veranschaulicht, wie das RegularExpressionValidator-Steuerelement zur Validierung einer fünfstelligen Postleitzahl verwendet wird.

<%@ 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 Example</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" 
                     runat="server"/>
             </td>
          </tr>
 
          <tr>
             <td colspan="3">
                <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"
                     ErrorMessage="Zip code must be 5 numeric digits"
                     EnableClientScript="False" 
                     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>
 
<%@ 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 Example</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" 
                     runat="server"/>
             </td>
          </tr>
 
          <tr>
             <td colspan="3">
                <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"
                     ErrorMessage="Zip code must be 5 numeric digits"
                     EnableClientScript="False" 
                     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>
 
<%@ Page Language="JScript" AutoEventWireup="True" %>

 <html>
 <head>

    <script runat="server">
 
       function ValidateBtn_Click(sender : Object, e : EventArgs) 
       {
          if (Page.IsValid) 
          {
             lblOutput.Text = "Page is Valid.";
          }
          else 
          {
             lblOutput.Text = "Page is InValid.";
          }
       }
 
    </script>
 
 </head>
 <body>
 
    <h3>RegularExpressionValidator Example</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" 
                     runat="server"/>
             </td>
          </tr>
 
          <tr>
             <td colspan="3">
                <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"
                     ErrorMessage="Zip code must be 5 numeric digits"
                     EnableClientScript="False" 
                     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>
 

.NET Framework-Sicherheit

Vererbungshierarchie

System.Object
   System.Web.UI.Control
     System.Web.UI.WebControls.WebControl
       System.Web.UI.WebControls.Label
         System.Web.UI.WebControls.BaseValidator
          System.Web.UI.WebControls.RegularExpressionValidator

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

RegularExpressionValidator-Member
System.Web.UI.WebControls-Namespace
BaseValidator-Klasse
BaseValidator.EnableClientScript-Eigenschaft
System.Text.RegularExpressions.Regex

Weitere Ressourcen

Reguläre Ausdrücke von .NET Framework