RegularExpressionValidator.ValidationExpression Eigenschaft

Definition

Ruft den regulären Ausdruck ab, der das Muster für die Überprüfung eines Felds angibt, oder legt diesen fest.Gets or sets the regular expression that determines the pattern used to validate a field.

public:
 property System::String ^ ValidationExpression { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
public string ValidationExpression { get; set; }
[System.Web.UI.Themeable(false)]
public string ValidationExpression { get; set; }
member this.ValidationExpression : string with get, set
Public Property ValidationExpression As String

Eigenschaftswert

Eine Zeichenfolge, die den regulären Ausdruck für die Überprüfung des Formats eines Felds angibt.A string that specifies the regular expression used to validate a field for format. Der Standardwert lautet Empty.The default is Empty.

Attribute

Ausnahmen

Der reguläre Ausdruck ist nicht korrekt gebildet.The regular expression is not properly formed.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie die ValidationExpression-Eigenschaft verwenden, um ein Feld mit fünf numerischen Ziffern zu validieren.The following example demonstrates how to use the ValidationExpression property to validate a field with five numeric digits. Beim Klicken auf das Button Steuerelement prüft der resultierende OnClick Ereignishandler die IsValid-Eigenschaft des Page, um zu bestimmen, ob der Text im TextBox dem regulären Ausdruck entspricht.When the Button control is clicked, the resulting OnClick event handler checks the IsValid property of the Page to determine whether the text in the TextBox satisfies the regular expression.

Wichtig

Dieses Beispiel umfasst ein Textfeld, das Benutzereingaben akzeptiert, die ein potenzielles Sicherheitsrisiko darstellen.This example has a text box that accepts user input, which is a potential security threat. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.For more information, see Script Exploits Overview.

<%@ Page Language="C#" AutoEventWireup="True" %>

 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
 <head>
    <title>RegularExpressionValidator Example</title>
<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> 
    <form id="form1" runat="server">
 
    <h3>RegularExpressionValidator Example</h3>

       <table style="background-color:#eeeeee; padding:10">
          <tr valign="top">
             <td colspan="3">
                <asp:Label ID="lblOutput" 
                     Text="Enter a 5-digit ZIP Code" 
                     runat="server"
                     AssociatedControlID="TextBox1"/>
             </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="VB" AutoEventWireup="True" %>

 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
 <head>
    <title>RegularExpressionValidator Example</title>
<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>
    <br />
 
    <form id="form1" runat="server">
 
       <table style="background-color:#eeeeee; padding:10">
          <tr valign="top">
             <td colspan="3">
                <asp:Label ID="lblOutput" 
                     Text="Enter a 5-digit ZIP Code" 
                     runat="server"
                     AssociatedControlID="TextBox1"/>
             </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>
 

Hinweise

Verwenden Sie diese Eigenschaft, um das Muster anzugeben, das zum Überprüfen auf vorhersagbare Zeichen folgen verwendet wird, z. b. auf die Sozialversicherungsnummern, e-Mail-Adressen, Telefonnummern und Postleitzahlen.Use this property to specify the pattern used to check for predictable sequences of characters, such as those in social security numbers, email addresses, telephone numbers, and postal codes.

Der RegularExpressionValidator führt keine Validierung für eine leere Zeichenfolge aus.The RegularExpressionValidator does not perform validation on an empty string. Wenn die zu testende Zeichenfolge leer sein kann, verwenden Sie die RequiredFieldValidator und die RegularExpressionValidator.If the string you are testing might be empty, use the RequiredFieldValidator as well as the RegularExpressionValidator.

Weitere Informationen zu regulären Ausdrücken finden Sie unter .NET Framework regulären Ausdrücken.For more information on regular expressions, see .NET Framework Regular Expressions.

Hinweis

Wenn beim Musterabgleich Konstrukte Probleme auftreten, versuchen Sie, den Ausdruck mit "^ (" und ") $" zu umwickeln.If you experience problems with pattern matching constructs, try wrapping the expression with "^(" and ")$". Beispielsweise wird "a|ab" zu "^ (a|ab) $".For example, "a|ab" becomes "^(a|ab)$".

Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden.This property cannot be set by themes or style sheet themes. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET-Designs und Skins.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

Gilt für: