CompareValidator クラスとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

CompareValidator クラス

指定できる比較演算子を使用し、あるコントロールの特定のフィールドと他のコントロールの特定のフィールドとを比較して有効性を判断します。

名前空間: System.Web.UI.MobileControls
アセンブリ: System.Web.Mobile (system.web.mobile.dll 内)
構文

Visual Basic (宣言)

Public Class CompareValidator
    Inherits BaseValidator

Visual Basic (使用法)

Dim instance As CompareValidator

public class CompareValidator : BaseValidator

C++

public ref class CompareValidator : public
 BaseValidator

public class CompareValidator extends BaseValidator

JScript

public class CompareValidator extends
 BaseValidator

解説

比較検証コントロールは、新しいパスワードを確認する場合など、2 つのテキストボックスの値が同じ値であることを確認するために使用します。

このクラスの動作は、ASP.NET の CompareValidator コントロールの動作と同じです。

既定では、サーバーにフォームが送信されると、Command コントロールは、検証を実行するための検証コントロールをフォーム上で発生させます。検証を自動的に実行しないようにするには、Command コントロール上の CausesValidation プロパティを false に設定します。

入力コントロールが空の場合、検証は成功します。RequiredFieldValidator コントロールを使用すると、データを入力コントロールに入力するようにユーザーに求めます。

使用例

次の例では、CompareValidator コントロール (CompareValidator1) を使用して、2 つのテキストボックスにある値が同じであるかどうかを調べ、同じ値でない場合はユーザーに警告します。

Visual Basic

<%@ Page Language="VB" 
    Inherits="System.Web.UI.MobileControls.MobilePage"
 %>
<%@ Register TagPrefix="mobile" 
    Namespace="System.Web.UI.MobileControls"
 
    Assembly="System.Web.Mobile"
 %>

<html  >
<body>
    <mobile:form id="form1" runat="server">
        <mobile:Label id="Label1" runat="server">Enter
 values
            </mobile:Label> 
        <mobile:TextBox id="TextBox1" runat="server"
 Text="abc" />
        <mobile:TextBox id="TextBox2" runat="server"
 Text="xyz" />
        <mobile:Command id="Command1" runat="server"
 Text="OK" />
        <mobile:CompareValidator ID="CompareValidator1"
 Runat="server" 
            ErrorMessage="Values are different" Operator="Equal"
            ControlToCompare="TextBox1"
            ControlToValidate="TextBox2" />
    </mobile:form>
</body>

</html>

<%@ Page Language="C#" 
    Inherits="System.Web.UI.MobileControls.MobilePage" %>
<%@ Register TagPrefix="mobile" 
    Namespace="System.Web.UI.MobileControls" 
    Assembly="System.Web.Mobile" %>

<html  >
<body>
    <mobile:form id="form1" runat="server">
        <mobile:Label id="Label1" runat="server">Enter
 values
            </mobile:Label> 
        <mobile:TextBox id="TextBox1" runat="server" Text="abc"
 />
        <mobile:TextBox id="TextBox2" runat="server" Text="xyz"
 />
        <mobile:Command id="Command1" runat="server" Text="OK"
 />
        <mobile:CompareValidator ID="CompareValidator1" Runat="server"
 
            ErrorMessage="Values are different" Operator="Equal"
            ControlToCompare="TextBox1"
            ControlToValidate="TextBox2" />
    </mobile:form>
</body>

</html>

.NET Framework のセキュリティ

AspNetHostingPermission (ホスト環境での動作に必要なアクセス許可)要求値 : LinkDemand; アクセス許可値 : Minimal。
AspNetHostingPermission (ホスト環境での動作に必要なアクセス許可)要求値 : InheritanceDemand; アクセス許可値 : Minimal。

継承階層

System.Object
   System.Web.UI.Control
     System.Web.UI.MobileControls.MobileControl
       System.Web.UI.MobileControls.TextControl
         System.Web.UI.MobileControls.BaseValidator
          System.Web.UI.MobileControls.CompareValidator

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1

参照

関連項目
CompareValidator メンバ
System.Web.UI.MobileControls 名前空間
その他の技術情報
CompareValidator コントロールの概要

CompareValidator クラス

ユーザーが入力コントロールに入力した値を、別の入力コントロールに入力された値または定数値のいずれかと比較します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Class CompareValidator
    Inherits BaseCompareValidator

Visual Basic (使用法)

Dim instance As CompareValidator

public class CompareValidator : BaseCompareValidator

C++

public ref class CompareValidator : public
 BaseCompareValidator

public class CompareValidator extends BaseCompareValidator

JScript

public class CompareValidator extends
 BaseCompareValidator

解説

CompareValidator コントロールを使用すると、ユーザーが TextBox などの入力コントロールに入力した値を、別の入力コントロールに入力された値または定数値のいずれかと比較できます。また CompareValidator コントロールを使用すると、入力コントロールに入力された値を BaseCompareValidator.Type プロパティが指定するデータ型に変換できるかどうか示すことができます。

ControlToValidate プロパティを設定して、検証する入力コントロールを指定します。特定の入力コントロールをほかの入力コントロールと比較する場合は、ControlToCompare プロパティを設定して比較するコントロールを指定します。

メモ
ControlToCompare プロパティが指定する入力コントロールに入力された値を BaseCompareValidator.Type プロパティが指定するデータ型に変換できなくても、ControlToValidate プロパティが指定するデータ型には変換できる場合、検証対象の入力コントロールは有効と見なされます。したがって、ControlToCompare プロパティが指定した入力コントロールに、CompareValidator コントロールまたは RangeValidator コントロールを配置する必要もあります。

メモ

ControlToCompare プロパティが指定する入力コントロールに入力された値を BaseCompareValidator.Type プロパティが指定するデータ型に変換できなくても、ControlToValidate プロパティが指定するデータ型には変換できる場合、検証対象の入力コントロールは有効と見なされます。したがって、ControlToCompare プロパティが指定した入力コントロールに、CompareValidator コントロールまたは RangeValidator コントロールを配置する必要もあります。

入力コントロールの値を別の入力コントロールの値と比較する代わりに、入力コントロールの値を定数値と比較できます。比較する定数値を指定するには、ValueToCompare プロパティを設定します。

メモ
ValueToCompare プロパティが指定した値を BaseCompareValidator.Type プロパティが指定するデータ型に変換できない場合には、例外がスローされます。プログラムによって ValueToCompare プロパティに値を代入する前に、値のデータ型を確認してください。

メモ
ControlToCompare プロパティと ValueToCompare プロパティを同時に設定しないでください。入力コントロールの値を別の入力コントロールまたは定数値のいずれかと比較できます。両方のプロパティを設定した場合は、ControlToCompare プロパティが優先されます。

Operator プロパティを使用して、より大きい、等しいなどの実行する比較の型を指定します。Operator プロパティを ValidationCompareOperator.DataTypeCheck に設定すると、CompareValidator コントロールは ControlToCompare プロパティと ValueToCompare プロパティを無視し、入力コントロールに入力された値を BaseCompareValidator.Type プロパティが指定するデータ型に変換できるかどうかだけ示します。

BaseCompareValidator.Type プロパティは、2 つの比較値のデータ型を指定するのに使用されます。2 つの値は、比較演算が実行される前に指定したデータ型に自動的に変換されます。比較できる各種のデータ型の一覧を次の表に示します。

データ型	説明
String	文字列型
Integer	32 ビット符号付き整数型
Double	倍精度浮動小数点数型
Date	日付型
Currency	通貨記号を含めることができる 10 進数データ型

メモ
入力コントロールが空の場合、検証関数は呼び出されず、検証は成功します。RequiredFieldValidator コントロールを使用すると、データを入力コントロールに入力するようにユーザーに要求します。

検証コントロールの詳細については、「BaseValidator」を参照してください。

ユーザー補助

このコントロールに既定でレンダリングされるマークアップは、Web Content Accessibility Guidelines (WCAG) 1.0 の優先度 1 ガイドラインなどのユーザー補助に関する標準に適合しない可能性があります。このコントロールのユーザー補助サポートの詳細については、「ASP.NET コントロールとユーザー補助」を参照してください。

Topic	Location
方法 : ASP.NET サーバーコントロールに必要なエントリを検証する	ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバーコントロールのカスタム検証メッセージを表示する	ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバーコントロールのデータベースの値を検証する	ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバーコントロールのデータ型を検証する	ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバーコントロールのパターンに対して検証する	ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバーコントロールの値の範囲を検証する	ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバーコントロールの固有の値を検証する	ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバーコントロールの埋め込み先メッセージのレイアウトを指定する	ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバーコントロールの有効性をプログラムでテストする	ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバーコントロールの検証エラーメッセージの書式を設定する	ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバーコントロールの検証を無効にする	ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバーコントロールをカスタム関数で検証する	ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバーコントロールをプログラムで検証する	ASP .NET Web アプリケーションの作成

使用例

CompareValidator コントロールを使用して、2 つの TextBox コントロールの値を比較する方法を次のコード例に示します。

Visual Basic

<%@ Page Language="VB" AutoEventWireup="True"
 %>
 
<html>
<head>
   <script runat="server">
 
      Sub Button_Click(sender As Object,
 e As EventArgs) 
 
         If Page.IsValid Then 
         
            lblOutput.Text = "Result: Valid!"
         
         Else 
         
            lblOutput.Text = "Result: Not valid!"
         
         End If

      End Sub
 
      Sub Operator_Index_Changed(sender As
 Object, e As EventArgs) 

         Compare1.Operator = CType(ListOperator.SelectedIndex, ValidationCompareOperator)
         Compare1.Validate()

      End Sub

      Sub Type_Index_Changed(sender As Object,
 e As EventArgs) 

         Compare1.Type = CType(ListType.SelectedIndex, ValidationDataType)
         Compare1.Validate()

      End Sub
 
   </script>
 
</head>
<body>
 
   <form runat=server>

      <h3>CompareValidator Example</h3>
      <p>
      Enter a value in each textbox. Select
 a comparison operator<br>
      and data type. Click "Validate"
 to compare values.
 
      <table bgcolor="#eeeeee" cellpadding=10>

         <tr valign="top">

            <td>

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

            </td>

            <td>

               <h5>Comparison Operator:</h5>
 
               <asp:ListBox id="ListOperator" 
                    OnSelectedIndexChanged="Operator_Index_Changed"
 
                    runat="server">

                  <asp:ListItem Selected Value="Equal">Equal</asp:ListItem>
                  <asp:ListItem Value="NotEqual">NotEqual</asp:ListItem>
                  <asp:ListItem Value="GreaterThan">GreaterThan</asp:ListItem>
                  <asp:ListItem Value="GreaterThanEqual">GreaterThanEqual</asp:ListItem>
                  <asp:ListItem Value="LessThan">LessThan</asp:ListItem>
                  <asp:ListItem Value="LessThanEqual">LessThanEqual</asp:ListItem>
                  <asp:ListItem Value="DataTypeCheck">DataTypeCheck</asp:ListItem>

               </asp:ListBox>

            </td>

            <td>

               <h5>String 2:</h5>
               <asp:TextBox id="TextBox2" 
                    runat="server"/>
               <p>
               <asp:Button id="Button1"
                    Text="Validate"  
                    OnClick="Button_Click" 
                    runat="server"/>

            </td>
         </tr>

         <tr>
            <td colspan="3" align="center">

               <h5>Data Type:</h5>

               <asp:ListBox id="ListType" 
                    OnSelectedIndexChanged="Type_Index_Changed"
 
                    runat="server">

                  <asp:ListItem Selected Value="String"
 >String</asp:ListItem>
                  <asp:ListItem Value="Integer"
 >Integer</asp:ListItem>
                  <asp:ListItem Value="Double"
 >Double</asp:ListItem>
                  <asp:ListItem Value="Date" >Date</asp:ListItem>
                  <asp:ListItem Value="Currency"
 >Currency</asp:ListItem>

               </asp:ListBox>
            </td>
         </tr>
      </table>
 
      <asp:CompareValidator id="Compare1" 
           ControlToValidate="TextBox1" 
           ControlToCompare="TextBox2"
           EnableClientScript="False" 
           Type="String" 
           runat="server"/>
 
      <br>
       
      <asp:Label id="lblOutput" 
           Font-Name="verdana" 
           Font-Size="10pt" 
           runat="server"/>
 
   </form>
 
</body>
</html>

<%@ Page Language="C#" AutoEventWireup="True" %>
 
<html>
<head>
   <script runat="server">
 
      void Button_Click(Object sender, EventArgs e) 
      {
 
         if (Page.IsValid) 
         {
            lblOutput.Text = "Result: Valid!";
         }
         else 
         {
            lblOutput.Text = "Result: Not valid!";
         }

      }
 
      void Operator_Index_Changed(Object sender, EventArgs e)
 
      {

         Compare1.Operator = (ValidationCompareOperator) ListOperator.SelectedIndex;
         Compare1.Validate();

      }

      void Type_Index_Changed(Object sender, EventArgs e) 
      {

         Compare1.Type = (ValidationDataType) ListType.SelectedIndex;
         Compare1.Validate();

      }
 
   </script>
 
</head>
<body>
 
   <form runat=server>

      <h3>CompareValidator Example</h3>
      <p>
      Enter a value in each textbox. Select a comparison operator<br>
      and data type. Click "Validate" to compare values.
 
      <table bgcolor="#eeeeee" cellpadding=10>

         <tr valign="top">

            <td>

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

            </td>

            <td>

               <h5>Comparison Operator:</h5>
 
               <asp:ListBox id="ListOperator" 
                    OnSelectedIndexChanged="Operator_Index_Changed" 
                    runat="server">

                  <asp:ListItem Selected Value="Equal">Equal</asp:ListItem>
                  <asp:ListItem Value="NotEqual">NotEqual</asp:ListItem>
                  <asp:ListItem Value="GreaterThan">GreaterThan</asp:ListItem>
                  <asp:ListItem Value="GreaterThanEqual">GreaterThanEqual</asp:ListItem>
                  <asp:ListItem Value="LessThan">LessThan</asp:ListItem>
                  <asp:ListItem Value="LessThanEqual">LessThanEqual</asp:ListItem>
                  <asp:ListItem Value="DataTypeCheck">DataTypeCheck</asp:ListItem>

               </asp:ListBox>

            </td>

            <td>

               <h5>String 2:</h5>
               <asp:TextBox id="TextBox2" 
                    runat="server"/>
               <p>
               <asp:Button id="Button1"
                    Text="Validate"  
                    OnClick="Button_Click" 
                    runat="server"/>

            </td>
         </tr>

         <tr>
            <td colspan="3" align="center">

               <h5>Data Type:</h5>

               <asp:ListBox id="ListType" 
                    OnSelectedIndexChanged="Type_Index_Changed" 
                    runat="server">

                  <asp:ListItem Selected Value="String" >String</asp:ListItem>
                  <asp:ListItem Value="Integer" >Integer</asp:ListItem>
                  <asp:ListItem Value="Double" >Double</asp:ListItem>
                  <asp:ListItem Value="Date" >Date</asp:ListItem>
                  <asp:ListItem Value="Currency" >Currency</asp:ListItem>

               </asp:ListBox>
            </td>
         </tr>
      </table>
 
      <asp:CompareValidator id="Compare1" 
           ControlToValidate="TextBox1" 
           ControlToCompare="TextBox2"
           EnableClientScript="False" 
           Type="String" 
           runat="server"/>
 
      <br>
       
      <asp:Label id="lblOutput" 
           Font-Name="verdana" 
           Font-Size="10pt" 
           runat="server"/>
 
   </form>
 
</body>
</html>

JScript

<%@ Page Language="JScript" AutoEventWireup="True" %>
 
<html>
<head>
   <script runat="server">
 
      function Button_Click(sender, e : EventArgs) 
      {
 
         if (Page.IsValid) 
         {
            lblOutput.Text = "Result: Valid!";
         }
         else 
         {
            lblOutput.Text = "Result: Not valid!";
         }

      }
 
      function Operator_Index_Changed(sender, e : EventArgs) 
      {

         Compare1.Operator = ValidationCompareOperator(ListOperator.SelectedIndex);
         Compare1.Validate();

      }

      function Type_Index_Changed(sender, e : EventArgs) 
      {

         Compare1.Type = ValidationDataType(ListType.SelectedIndex);
         Compare1.Validate();

      }
 
   </script>
 
</head>
<body>
 
   <form runat=server>

      <h3>CompareValidator Example</h3>
      <p>
      Enter a value in each textbox. Select a comparison operator<br>
      and data type. Click "Validate" to compare values.
 
      <table bgcolor="#eeeeee" cellpadding=10>

         <tr valign="top">

            <td>

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

            </td>

            <td>

               <h5>Comparison Operator:</h5>
 
               <asp:ListBox id="ListOperator" 
                    OnSelectedIndexChanged="Operator_Index_Changed" 
                    runat="server">

                  <asp:ListItem Selected Value="Equal">Equal</asp:ListItem>
                  <asp:ListItem Value="NotEqual">NotEqual</asp:ListItem>
                  <asp:ListItem Value="GreaterThan">GreaterThan</asp:ListItem>
                  <asp:ListItem Value="GreaterThanEqual">GreaterThanEqual</asp:ListItem>
                  <asp:ListItem Value="LessThan">LessThan</asp:ListItem>
                  <asp:ListItem Value="LessThanEqual">LessThanEqual</asp:ListItem>
                  <asp:ListItem Value="DataTypeCheck">DataTypeCheck</asp:ListItem>

               </asp:ListBox>

            </td>

            <td>

               <h5>String 2:</h5>
               <asp:TextBox id="TextBox2" 
                    runat="server"/>
               <p>
               <asp:Button id="Button1"
                    Text="Validate"  
                    OnClick="Button_Click" 
                    runat="server"/>

            </td>
         </tr>

         <tr>
            <td colspan="3" align="center">

               <h5>Data Type:</h5>

               <asp:ListBox id="ListType" 
                    OnSelectedIndexChanged="Type_Index_Changed" 
                    runat="server">

                  <asp:ListItem Selected Value="String" >String</asp:ListItem>
                  <asp:ListItem Value="Integer" >Integer</asp:ListItem>
                  <asp:ListItem Value="Double" >Double</asp:ListItem>
                  <asp:ListItem Value="Date" >Date</asp:ListItem>
                  <asp:ListItem Value="Currency" >Currency</asp:ListItem>

               </asp:ListBox>
            </td>
         </tr>
      </table>
 
      <asp:CompareValidator id="Compare1" 
           ControlToValidate="TextBox1" 
           ControlToCompare="TextBox2"
           EnableClientScript="False" 
           Type="String" 
           runat="server"/>
 
      <br>
       
      <asp:Label id="lblOutput" 
           Font-Name="verdana" 
           Font-Size="10pt" 
           runat="server"/>
 
   </form>
 
</body>
</html>

継承階層

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.BaseCompareValidator
            System.Web.UI.WebControls.CompareValidator

スレッドセーフ

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
CompareValidator メンバ
System.Web.UI.WebControls 名前空間
BaseValidator クラス
BaseCompareValidator クラス
TextBox
BaseValidator.ControlToValidate プロパティ
ControlToCompare
ValueToCompare
Operator
BaseCompareValidator.Type プロパティ
RequiredFieldValidator

このページでは「.NET Framework クラスライブラリリファレンス」からCompareValidator クラスを検索した結果を表示しています。
Weblioに収録されているすべての辞書からCompareValidator クラスを検索する場合は、下記のリンクをクリックしてください。

全ての辞書からCompareValidator クラスを検索

>> 「CompareValidator クラス」を含む用語の索引
CompareValidator クラスのページへのリンク

CompareValidator クラスとは？わかりやすく解説

CompareValidator クラス

CompareValidator クラス

ユーザー補助

「CompareValidator クラス」の関連用語


	© 2025 Microsoft.All rights reserved.

CompareValidator クラスとは？ わかりやすく解説

CompareValidator クラス

CompareValidator クラス

ユーザー補助

「CompareValidator クラス」の関連用語

CompareValidator クラスとは？わかりやすく解説