مشاركة عبر

التحكم RegularExpressionValidator (مرجع عام)

  • مقالة

تقييم القيمة عنصر تحكم الإدخال إلى تحديد ما إذا كان يتطابق مع نقش المعرّفة من قِبل تعبير عادي.

<asp:RegularExpressionValidator
    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"
    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"
    ValidationExpression="string"
    ValidationGroup="string"
    Visible="True|False"
    Width="size"
/>

ملاحظات

RegularExpressionValidatorاستخدام عنصر التحكم إلى تحديد ما إذا كانت القيمة عنصر تحكم الإدخال يطابق نمط معرف من قبل تعبير عادي. يسمح لك هذا النوع من التحقق من صحة إلى البحث عن أفضل تسلسلات من أحرف مثل تلك الموجودة في أرقام الضمان الاجتماعي أو عناوين e-mail أو أرقام الهواتف الرموز البريدية وهكذا.

ملاحظةملاحظة

إذا كان عنصر تحكم الإدخال فارغاً, تسمى لا وظائف التحقق من صحة و نجاح التحقق من صحة.استخدام RequiredFieldValidatorالتحكم إلى منع المستخدم من التخطي عنصر تحكم الإدخال.

يتم إجراء التحقق من صحة العميل والحد من جانب الخادم إلا إذا لم يدعم المستعرض التحقق من صحة العميل أو معطّل التحقق من صحة العميل بشكل واضح (EnableClientScriptتم تعيين الخاصية إلى false).

استخدام ValidationExpressionخاصية لتحديد تعبير عادي المستخدمة للتحقق من صحة عنصر تحكم الإدخال. بناء الجملة التحقق من صحة تعبير عادي يكون مختلفاً قليلاً على العميل من الخادم. على العميل تعبير عادي JScript بناء الجملة يُستخدم. تشغيل الخادم Regexاستخدام بناء جملة. لأن بناء جملة JScript تعبير عادي عبارة عن مجموعة فرعية من Regexبناء الجملة, فمن المستحسن استخدام بناء جملة JScript تعبير عادي إلى نفس النتائج على كل العميل على الخادم.

للحصول على معلومات إضافية حول إنشاء تعابير عادية راجع تعابير عادية إطار عمل .NET.

للحصول على معلومات مفصلة حول RegularExpressionValidatorعنصر تحكم, راجع RegularExpressionValidatorفئة.

مثال

يلي تعليمات برمجية يوضح المثال كيفية استخدام RegularExpressionValidatorالتحكم للتحقق من صحة القيمة التي تم إدخالها في مربع نص عن نمط معين. في هذا المثال، يكون النقش الرموز البريدية ذات الخمسة أرقام. ثم يتم عرض نتائج التحقق من صحة على الصفحة.

<%@ 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 Sample</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 Sample</h3>
    <p/>

    <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" 
                     Font-Names="Verdana" 
                     Font-Size="10pt" 
                     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"
                     EnableClientScript="false"
                     ErrorMessage="ZIP Code must be 5 numeric digits"
                     runat="server"/>
             </td>
          </tr>
          <tr>
             <td></td>
             <td>
                <asp:Button ID="Button1" text="Validate" 
                     OnClick="ValidateBtn_Click" 
                     runat="server"/>
             </td>
             <td></td>
          </tr>
       </table>

    </form>

 </body>
 </html>  

 <%@ 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 Sample</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>

    <h3>RegularExpressionValidator Sample</h3>
    <p/>

    <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" 
                     Font-Names="Verdana" 
                     Font-Size="10pt" 
                     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"
                     EnableClientScript="false"
                     ErrorMessage="ZIP Code must be 5 numeric digits"
                     runat="server"/>
             </td>
          </tr>
          <tr>
             <td></td>
             <td>
                <asp:Button ID="Button1" text="Validate" 
                     OnClick="ValidateBtn_Click" 
                     runat="server"/>
             </td>
             <td></td>
          </tr>
       </table>

    </form>

 </body>
 </html>

راجع أيضًا:

المرجع

RegularExpressionValidator

موارد أخرى

بناء الجملة العنصر تحكم خادم التدقيق

تعابير عادية إطار عمل .NET