CompareValidator イベント

名前 | 説明 | |
---|---|---|
![]() | DataBinding | サーバー コントロールがデータ ソースに連結すると発生します。 ( Control から継承されます。) |
![]() | Disposed | サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。 ( Control から継承されます。) |
![]() | Init | サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。 ( Control から継承されます。) |
![]() | Load | サーバー コントロールが Page オブジェクトに読み込まれると発生します。 ( Control から継承されます。) |
![]() | PreRender | Control オブジェクトの読み込み後、表示を開始する前に発生します。 ( Control から継承されます。) |
![]() | Unload | サーバー コントロールがメモリからアンロードされると発生します。 ( Control から継承されます。) |

CompareValidator イベント

名前 | 説明 | |
---|---|---|
![]() | DataBinding | サーバー コントロールがデータ ソースに連結すると発生します。 ( Control から継承されます。) |
![]() | Disposed | サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。 ( Control から継承されます。) |
![]() | Init | サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。 ( Control から継承されます。) |
![]() | Load | サーバー コントロールが Page オブジェクトに読み込まれると発生します。 ( Control から継承されます。) |
![]() | PreRender | Control オブジェクトの読み込み後、表示を開始する前に発生します。 ( Control から継承されます。) |
![]() | Unload | サーバー コントロールがメモリからアンロードされると発生します。 ( Control から継承されます。) |

関連項目
CompareValidator クラスSystem.Web.UI.WebControls 名前空間
BaseValidator クラス
BaseCompareValidator クラス
TextBox
BaseValidator.ControlToValidate プロパティ
CompareValidator.ControlToCompare プロパティ
CompareValidator.ValueToCompare プロパティ
CompareValidator.Operator プロパティ
BaseCompareValidator.Type プロパティ
RequiredFieldValidator
CompareValidator クラス
アセンブリ: System.Web.Mobile (system.web.mobile.dll 内)


比較検証コントロールは、新しいパスワードを確認する場合など、2 つのテキスト ボックスの値が同じ値であることを確認するために使用します。
このクラスの動作は、ASP.NET の CompareValidator コントロールの動作と同じです。
既定では、サーバーにフォームが送信されると、Command コントロールは、検証を実行するための検証コントロールをフォーム上で発生させます。検証を自動的に実行しないようにするには、Command コントロール上の CausesValidation プロパティを false に設定します。
入力コントロールが空の場合、検証は成功します。RequiredFieldValidator コントロールを使用すると、データを入力コントロールに入力するようにユーザーに求めます。

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


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


Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


CompareValidator クラス
アセンブリ: System.Web (system.web.dll 内)


CompareValidator コントロールを使用すると、ユーザーが TextBox などの入力コントロールに入力した値を、別の入力コントロールに入力された値または定数値のいずれかと比較できます。また CompareValidator コントロールを使用すると、入力コントロールに入力された値を BaseCompareValidator.Type プロパティが指定するデータ型に変換できるかどうか示すことができます。
ControlToValidate プロパティを設定して、検証する入力コントロールを指定します。特定の入力コントロールをほかの入力コントロールと比較する場合は、ControlToCompare プロパティを設定して比較するコントロールを指定します。
![]() |
---|
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 つの値は、比較演算が実行される前に指定したデータ型に自動的に変換されます。比較できる各種のデータ型の一覧を次の表に示します。
![]() |
---|
入力コントロールが空の場合、検証関数は呼び出されず、検証は成功します。RequiredFieldValidator コントロールを使用すると、データを入力コントロールに入力するようにユーザーに要求します。 |
検証コントロールの詳細については、「BaseValidator」を参照してください。
ユーザー補助
このコントロールに既定でレンダリングされるマークアップは、Web Content Accessibility Guidelines (WCAG) 1.0 の優先度 1 ガイドラインなどのユーザー補助に関する標準に適合しない可能性があります。このコントロールのユーザー補助サポートの詳細については、「ASP.NET コントロールとユーザー補助」を参照してください。

CompareValidator コントロールを使用して、2 つの TextBox コントロールの値を比較する方法を次のコード例に示します。
<%@ 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>
<%@ 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.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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


CompareValidator コンストラクタ
アセンブリ: System.Web.Mobile (system.web.mobile.dll 内)


Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


CompareValidator コンストラクタ
アセンブリ: System.Web (system.web.dll 内)



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


CompareValidator プロパティ



CompareValidator プロパティ



CompareValidator メソッド



CompareValidator メソッド



CompareValidator メンバ
指定できる比較演算子を使用し、あるコントロールの特定のフィールドと他のコントロールの特定のフィールドとを比較して有効性を判断します。
CompareValidator データ型で公開されるメンバを以下の表に示します。

名前 | 説明 | |
---|---|---|
![]() | CompareValidator |





名前 | 説明 | |
---|---|---|
![]() | DataBinding | サーバー コントロールがデータ ソースに連結すると発生します。(Control から継承されます。) |
![]() | Disposed | サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。(Control から継承されます。) |
![]() | Init | サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。(Control から継承されます。) |
![]() | Load | サーバー コントロールが Page オブジェクトに読み込まれると発生します。(Control から継承されます。) |
![]() | PreRender | Control オブジェクトの読み込み後、表示を開始する前に発生します。(Control から継承されます。) |
![]() | Unload | サーバー コントロールがメモリからアンロードされると発生します。(Control から継承されます。) |

CompareValidator メンバ
ユーザーが入力コントロールに入力した値を、別の入力コントロールに入力された値または定数値のいずれかと比較します。
CompareValidator データ型で公開されるメンバを以下の表に示します。






名前 | 説明 | |
---|---|---|
![]() | DataBinding | サーバー コントロールがデータ ソースに連結すると発生します。(Control から継承されます。) |
![]() | Disposed | サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。(Control から継承されます。) |
![]() | Init | サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。(Control から継承されます。) |
![]() | Load | サーバー コントロールが Page オブジェクトに読み込まれると発生します。(Control から継承されます。) |
![]() | PreRender | Control オブジェクトの読み込み後、表示を開始する前に発生します。(Control から継承されます。) |
![]() | Unload | サーバー コントロールがメモリからアンロードされると発生します。(Control から継承されます。) |

- CompareValidatorのページへのリンク