مشاركة عبر

عنصر التحكم RangeValidator (مرجع عام)

  • مقالة

تقييم قيمة عنصر تحكم الإدخال لتحديد ما إذا كان بين حدود عليا وحدود المحدد.

<asp:RangeValidator
    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"
    CultureInvariantValues="True|False"
    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"
    MaximumValue="string"
    MinimumValue="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"
    Type="String|Integer|Double|Date|Currency"
    ValidationGroup="string"
    Visible="True|False"
    Width="size"
/>

ملاحظات

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

استخدام ControlToValidateالخاصية لتحديد عنصر إدخال التحقق من صحة. MinimumValueو MaximumValueخصائص تحديد الحد الأدنى والحد الأقصى للنطاق القيم الصالح على التوالي.

Typeاستخدام الخاصية لتحديد نوع بيانات القيم للمقارنة. لمقارنة القيم المحولة لنوع البيانات هذا قبل تنفيذ أي مقارنة .

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

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

RangeValidatorالتحكم يرمي إلى‏ استثناء ما إذا كانت القيمة المحددة بواسطة MaximumValueأو MinimumValueلا يمكن تحويل الخاصية لنوع البيانات المحددة بواسطة Typeالخاصية.على سبيل المثال، عند RangeValidatorعنصر تحكم Typeتعيين الخاصية إلى "العملة" MinimumValueو MaximumValueيجب توفير خصائص بتنسيق مثل الموضح في NumberFormatInfo.CurrencyDecimalDigits، وإلا إلقاء استثناء.

لمزيد من المعلومات، راجع فئة RangeValidator أو System.Web.UI.WebControls.RangeValidator.

مثال

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

ملاحظة الأمانملاحظة الأمان

يحتوي هذا المثال على مربع نص يقبل إدخال المستخدم و الذي يعد تهديد أمان محتمل.بشكل افتراضي، تتحقق صفحات ويب ASP.NET من أن مُدخلات المستخدم لا تتضمن برنامج نصي أو عناصر 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>RangeValidator Control (General Reference)</title>

   <script runat="server">

      Sub ButtonClick(sender As Object, e As EventArgs)

         If Page.IsValid Then

            Label1.Text="Page is valid."

         Else

            Label1.Text="Page is not valid!!"

         End If

      End Sub

   </script>

</head>

<body>

   <form id="Form1" runat="server">

      <h3>RangeValidator Example</h3>

      Enter a number from 1 to 10:

      <br />

      <asp:TextBox id="TextBox1"
           runat="server"/>

      <br />

      <asp:RangeValidator id="Range1"
           ControlToValidate="TextBox1"
           MinimumValue="1"
           MaximumValue="10"
           Type="Integer"
           EnableClientScript="false"
           Text="The value must be from 1 to 10!"
           runat="server"/>

      <p />

      <asp:Label id="Label1"
           runat="server"/>

      <p />

      <asp:Button id="Button1"
           Text="Submit"
           OnClick="ButtonClick"
           runat="server"/>


   </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>RangeValidator Control (General Reference)</title>

   <script runat="server">

      void ButtonClick(Object sender, EventArgs e)
      {

         if (Page.IsValid)
         {
            Label1.Text="Page is valid.";
         }
         else
         {
            Label1.Text="Page is not valid!!";
         }

      }

   </script>

</head>

<body>

   <form id="Form1" runat="server">

      <h3>RangeValidator Example</h3>

      Enter a number from 1 to 10:

      <br />

      <asp:TextBox id="TextBox1"
           runat="server"/>

      <br />

      <asp:RangeValidator id="Range1"
           ControlToValidate="TextBox1"
           MinimumValue="1"
           MaximumValue="10"
           Type="Integer"
           EnableClientScript="false"
           Text="The value must be from 1 to 10!"
           runat="server"/>

      <p />

      <asp:Label id="Label1"
           runat="server"/>

      <p />

      <asp:Button id="Button1"
           Text="Submit"
           OnClick="ButtonClick"
           runat="server"/>


   </form>

</body>
</html>

راجع أيضًا:

المرجع

RangeValidator

موارد أخرى

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