LinkButton.ValidationGroup プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
LinkButton コントロールがサーバーにポストバックされるときに検証が実行されるコントロールのグループを取得または設定します。
public:
virtual property System::String ^ ValidationGroup { System::String ^ get(); void set(System::String ^ value); };
[System.Web.UI.Themeable(false)]
public virtual string ValidationGroup { get; set; }
[<System.Web.UI.Themeable(false)>]
member this.ValidationGroup : string with get, set
Public Overridable Property ValidationGroup As String
プロパティ値
LinkButton コントロールがサーバーにポストバックされるときに検証が実行されるコントロールのグループ。 既定値は空の文字列 ("") です。
実装
- 属性
例
次のコード例は、プロパティを ValidationGroup 使用して、コントロールがサーバーにポストバックしたときに LinkButton 検証されるコントロールを指定する方法を示しています。 このページには、ユーザーからのデータをキャプチャする 3 つのテキスト ボックスと、ユーザーがテキスト ボックスを空白のままにしないようにする 3 つの RequiredFieldValidator コントロールが含まれています。 最初の 2 つのテキスト ボックスのコントロールは RequiredFieldValidator 検証グループ内にあり PersonalInfoGroup
、3 番目の RequiredFieldValidator テキスト ボックスのコントロールは検証グループにあります LocationInfoGroup
。 クリックすると LinkButton1
、検証グループ PersonalInfoGroup
内のコントロールのみが検証されます。 クリックすると LinkButton2
、検証グループ LocationInfoGroup
内のコントロールのみが検証されます。
重要
この例には、ユーザー入力を受け付けるテキスト ボックスがあります。これにより、セキュリティが脆弱になる可能性があります。 既定では、ASP.NET Web ページによって、ユーザー入力にスクリプトまたは HTML 要素が含まれていないかどうかが検証されます。 詳細については、「スクリプトによる攻略の概要」を参照してください。
<%@ page language="C#" %>
<!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 id="head1" runat="server">
<title>LinkButton.ValidationGroup Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>LinkButton.ValidationGroup Example</h3>
<asp:label id="NameLabel"
text="Enter your name:"
runat="Server"
AssociatedControlID="NameTextBox">
</asp:label>
 
<asp:textbox id="NameTextBox"
runat="Server">
</asp:textbox>
 
<asp:requiredfieldvalidator id="RequiredFieldValidator1"
controltovalidate="NameTextBox"
validationgroup="PersonalInfoGroup"
errormessage="Enter your name."
runat="Server">
</asp:requiredfieldvalidator>
<br /><br />
<asp:label id="AgeLabel"
text="Enter your age:"
runat="Server"
AssociatedControlID="AgeTextBox">
</asp:label>
 
<asp:textbox id="AgeTextBox"
runat="Server">
</asp:textbox>
 
<asp:requiredfieldvalidator id="RequiredFieldValidator2"
controltovalidate="AgeTextBox"
validationgroup="PersonalInfoGroup"
errormessage="Enter your age."
runat="Server">
</asp:requiredfieldvalidator>
<br /><br />
<!--When LinkButton1 is clicked, only validation
controls that are a part of PersonalInfoGroup
are validated.-->
<asp:linkbutton id="LinkButton1"
text="Validate"
causesvalidation="true"
validationgroup="PersonalInfoGroup"
runat="Server">
</asp:linkbutton>
<br /><br />
<asp:label id="CityLabel"
text="Enter your city of residence:"
runat="Server"
AssociatedControlID="CityTextBox">
</asp:label>
 
<asp:textbox id="CityTextBox"
runat="Server">
</asp:textbox>
 
<asp:requiredfieldvalidator id="RequiredFieldValidator3"
controltovalidate="CityTextBox"
validationgroup="LocationInfoGroup"
errormessage="Enter a city name."
runat="Server">
</asp:requiredfieldvalidator>
<br /><br />
<!--When LinkButton2 is clicked, only validation
controls that are a part of LocationInfoGroup
are validated.-->
<asp:linkbutton id="LinkButton2"
text="Validate"
causesvalidation="true"
validationgroup="LocationInfoGroup"
runat="Server">
</asp:linkbutton>
</form>
</body>
</html>
<%@ page language="VB" %>
<!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 id="head1" runat="server">
<title>LinkButton.ValidationGroup Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>LinkButton.ValidationGroup Example</h3>
<asp:label id="NameLabel"
text="Enter your name:"
runat="Server"
AssociatedControlID="NameTextBox">
</asp:label>
 
<asp:textbox id="NameTextBox"
runat="Server">
</asp:textbox>
 
<asp:requiredfieldvalidator id="RequiredFieldValidator1"
controltovalidate="NameTextBox"
validationgroup="PersonalInfoGroup"
errormessage="Enter your name."
runat="Server">
</asp:requiredfieldvalidator>
<br /><br />
<asp:label id="AgeLabel"
text="Enter your age:"
runat="Server"
AssociatedControlID="AgeTextBox">
</asp:label>
 
<asp:textbox id="AgeTextBox"
runat="Server">
</asp:textbox>
 
<asp:requiredfieldvalidator id="RequiredFieldValidator2"
controltovalidate="AgeTextBox"
validationgroup="PersonalInfoGroup"
errormessage="Enter your age."
runat="Server">
</asp:requiredfieldvalidator>
<br /><br />
<!--When LinkButton1 is clicked, only validation
controls that are a part of PersonalInfoGroup
are validated.-->
<asp:linkbutton id="LinkButton1"
text="Validate"
causesvalidation="true"
validationgroup="PersonalInfoGroup"
runat="Server">
</asp:linkbutton>
<br /><br />
<asp:label id="CityLabel"
text="Enter your city of residence:"
runat="Server"
AssociatedControlID="CityTextBox">
</asp:label>
 
<asp:textbox id="CityTextBox"
runat="Server">
</asp:textbox>
 
<asp:requiredfieldvalidator id="RequiredFieldValidator3"
controltovalidate="CityTextBox"
validationgroup="LocationInfoGroup"
errormessage="Enter a city name."
runat="Server">
</asp:requiredfieldvalidator>
<br /><br />
<!--When LinkButton2 is clicked, only validation
controls that are a part of LocationInfoGroup
are validated.-->
<asp:linkbutton id="LinkButton2"
text="Validate"
causesvalidation="true"
validationgroup="LocationInfoGroup"
runat="Server">
</asp:linkbutton>
</form>
</body>
</html>
注釈
検証グループを使用すると、ページ上の検証コントロールを特定のカテゴリに割り当てることができます。 各検証グループは、ページ上の他の検証グループとは別に検証できます。 このプロパティを ValidationGroup 使用して、コントロールがサーバーにポストバックするときに検証を LinkButton 行う検証グループの名前を指定します。
このプロパティは、プロパティの CausesValidation 値が に設定 true
されている場合にのみ有効です。 プロパティの ValidationGroup 値を指定すると、指定したグループの一部である検証コントロールのみが、コントロールがサーバーにポストバックするときに LinkButton 検証されます。 このプロパティの値を指定せず、 CausesValidation プロパティが設定 true
されている場合、検証グループに割り当てられないページ上のすべての検証コントロールは、コントロールがサーバーに戻るときに検証されます。
このプロパティは、テーマまたはスタイル シート テーマによって設定することはできません。 詳細については、「テーマとスキン」を参照ThemeableAttributeして ASP.NET してください。