BaseValidator.ValidationGroup プロパティ
アセンブリ: System.Web (system.web.dll 内)
構文Dim instance As BaseValidator Dim value As String value = instance.ValidationGroup instance.ValidationGroup = value
[ThemeableAttribute(false)] public: virtual property String^ ValidationGroup { String^ get (); void set (String^ value); }
/** @property */ public String get_ValidationGroup () /** @property */ public void set_ValidationGroup (String value)
public function get ValidationGroup () : String public function set ValidationGroup (value : String)
この検証コントロールが属する検証グループの名前。既定値は空の文字列 ("") です。このプロパティが設定されていないことを示します。
解説ASP.NET には、サーバーに対するポストバック機能を持つ多数のコントロールが用意されています。これらのコントロールのうち、いずれかのコントロールの CausesValidation プロパティを true に設定すると、そのコントロールがサーバーにポストバックするときに検証が実行されます。サーバーへのポストバック機能を持つコントロールを次に示します。
-
System.Web.UI.WebControls.BulletedList
-
System.Web.UI.WebControls.Button
-
System.Web.UI.WebControls.CheckBox
-
System.Web.UI.WebControls.CheckBoxList
-
System.Web.UI.WebControls.DropDownList
-
System.Web.UI.HtmlControls.HtmlButton
-
System.Web.UI.HtmlControls.HtmlInputButton
-
System.Web.UI.HtmlControls.HtmlInputImage
-
System.Web.UI.WebControls.ImageButton
-
System.Web.UI.WebControls.LinkButton
-
System.Web.UI.WebControls.ListBox
-
System.Web.UI.WebControls.RadioButtonList
-
System.Web.UI.WebControls.TextBox
.gif) メモ |
|---|
| これらのコントロールの一部は、AutoPostBack プロパティを true に設定すると、サーバーにポスト バックします。 |
これらの各コントロールには ValidationGroup プロパティがあります。このプロパティを設定すると、そのコントロールでサーバーへのポストバックが発生するときに、指定したグループ内の検証コントロールだけが検証されます。検証コントロールを検証グループに割り当てるには、ValidationGroup プロパティを使用します。Page クラスは、ValidationGroup 入力パラメータを受け入れる GetValidators メソッドと Validate メソッドも公開します。
このプロパティをテーマ別またはスタイル シート テーマ別に設定することはできません。詳細については、ThemeableAttribute、ASP.NET のテーマとスキンの概要 の各トピックを参照してください。
使用例ValidationGroup プロパティを使用してグループに検証コントロールを割り当てるコード例を次に示します。
<%@ Page Language="VB" %> <html> <body> <form runat="server"> <h3>BaseValidator ValidationGroup Example</h3> Please enter your name:<br/> <asp:textbox id="NameTextBox" runat="server"/> <asp:requiredfieldvalidator id="NameTextBoxRequiredValidator" controltovalidate="NameTextBox" display="Dynamic" text="Please enter your name." validationgroup="UserInfoGroup" runat="server"/> <br><br> <asp:button id="SubmitButton" text="Submit" validationgroup="UserInfoGroup" runat="server"/> <hr/> Please enter a search topic:<br/> <asp:textbox id="SearchTextBox" runat="server"/> <asp:requiredfieldvalidator id="SearchTextBoxRequiredValidator" controltovalidate="SearchTextBox" display="Dynamic" text="Please enter a topic." validationgroup="SearchGroup" runat="server"/> <br><br> <asp:button id="SearchButton" text="Search" validationgroup="SearchGroup" runat="server"/> </form> </body> </html>
<%@ Page Language="C#" %> <html> <body> <form runat="server"> <h3>BaseValidator ValidationGroup Example</h3> Please enter your name:<br/> <asp:textbox id="NameTextBox" runat="server"/> <asp:requiredfieldvalidator id="NameTextBoxRequiredValidator" controltovalidate="NameTextBox" display="Dynamic" text="Please enter your name." validationgroup="UserInfoGroup" runat="server"/> <br><br> <asp:button id="SubmitButton" text="Submit" validationgroup="UserInfoGroup" runat="server"/> <hr/> Please enter a search topic:<br/> <asp:textbox id="SearchTextBox" runat="server"/> <asp:requiredfieldvalidator id="SearchTextBoxRequiredValidator" controltovalidate="SearchTextBox" display="Dynamic" text="Please enter a topic." validationgroup="SearchGroup" runat="server"/> <br><br> <asp:button id="SearchButton" text="Search" validationgroup="SearchGroup" runat="server"/> </form> </body> </html>
プラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照- BaseValidator.ValidationGroup プロパティのページへのリンク
