다음을 통해 공유

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 컨트롤을 사용합니다.

참고

MaximumValue 또는 MinimumValue 속성에 지정된 값을 Type 속성에 지정된 데이터 형식으로 변환할 수 없는 경우 RangeValidator 컨트롤에서 예외를 throw합니다.예를 들어 RangeValidator 컨트롤의 Type 속성이 "Currency"로 설정된 경우 MinimumValue 및 MaximumValue 속성을 NumberFormatInfo.CurrencyDecimalDigits에 설명된 형식으로 제공해야 하며, 그렇지 않으면 예외가 throw됩니다.

RangeValidator 컨트롤에 대한 자세한 내용은 System.Web.UI.WebControls.RangeValidator 클래스를 참조하십시오.

예제

다음 코드 예제에서는 텍스트 상자에 1과 10 사이의 값을 입력했는지 여부를 확인하기 위해RangeValidator 컨트롤을 사용하는 방법을 보여 줍니다. 유효성 검사 결과가 페이지에 표시됩니다.

보안 정보보안 정보

이 예제에는 사용자 입력을 허용하는 텍스트 상자가 있으므로 보안상 위험할 수 있습니다.기본적으로 ASP.NET 웹 페이지에서는 사용자 입력 내용에 스크립트나 HTML 요소가 포함되어 있지 않은지 확인합니다.자세한 내용은 Script Exploits Overview를 참조하십시오.

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

기타 리소스

유효성 검사 서버 컨트롤 구문