HtmlInputButton.ValidationGroup 屬性
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
取得或設定控制項群組，HtmlInputButton 會在回傳至伺服器時，針對這個群組進行驗證。
public:
virtual property System::String ^ ValidationGroup { System::String ^ get(); void set(System::String ^ value); };public virtual string ValidationGroup { get; set; }member this.ValidationGroup : string with get, setPublic Overridable Property ValidationGroup As String屬性值
控制項群組，HtmlInputButton 控制項會在回傳至伺服器時，針對這個群組進行驗證。 預設值是空字串 ("")，表示未設定這個屬性。
範例
下列程式碼範例示範如何使用 ValidationGroup 屬性來指定控制項在控制項回傳至伺服器時 HtmlInputButton 驗證的控制項。 頁面包含兩個文字方塊，可從使用者擷取資料，以及兩 RequiredFieldValidator 個控制項，以確保使用者不會將文字方塊保留空白。 第 RequiredFieldValidator 一個文字方塊的控制項位於驗證群組中 CityInfoGroup ， RequiredFieldValidator 而第二個方塊的控制項位於驗證群組中 StateInfoGroup 。 CityQueryButton按一下 時，只會驗證驗證群組中的 CityInfoGroup 控制項。 StateQueryButton按一下 時，只會驗證驗證群組中的 StateInfoGroup 控制項。
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void SubmitButton_Click(Object sender, EventArgs e)
{
// Determine which button was clicked.
switch (((HtmlInputButton)sender).ID)
{
case "CityQueryButton":
// Take the appropriate action if the controls pass validation.
if (CityReqValidator.IsValid)
{
Message.InnerHtml = "You have chosen to run a query for the following city: " +
CityTextBox.Value;
}
break;
case "StateQueryButton":
// Take the appropriate action if the controls pass validation.
if (StateReqValidator.IsValid)
{
Message.InnerHtml = "You have chosen to run a query for the following state: " +
StateTextBox.Value;
}
break;
default:
// If the button clicked is not recognized, erase the message on the page.
Message.InnerHtml = "";
break;
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>HtmlInputButton ValidationGroup Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3> HtmlInputButton ValidationGroup Example </h3>
<table border="1" cellpadding="10">
<tr>
<td>
<b>Enter city to query.</b> <br />
<input id="CityTextBox"
type="Text"
runat="server"/>
<asp:RequiredFieldValidator ID="CityReqValidator"
ControlToValidate="CityTextBox"
ValidationGroup="CityInfoGroup"
ErrorMessage="<br />Please enter a city."
Display="Dynamic"
EnableClientScript="False"
runat="server"/>
</td>
<td valign="bottom">
<input id="CityQueryButton"
type="Submit"
value="Submit"
causesvalidation="True"
validationgroup="CityInfoGroup"
onserverclick="SubmitButton_Click"
runat="server"/>
</td>
</tr>
<tr>
<td>
<b>Enter state to query.</b> <br />
<input id="StateTextBox"
type="Text"
runat="server"/>
<asp:RequiredFieldValidator ID="StateReqValidator"
ControlToValidate="StateTextBox"
ValidationGroup="StateInfoGroup"
ErrorMessage="<br />Please enter a state."
Display="Dynamic"
EnableClientScript="False"
runat="server"/>
</td>
<td valign="bottom">
<input id="StateQueryButton"
type="Submit"
value="Submit"
causesvalidation="True"
validationgroup="StateInfoGroup"
onserverclick="SubmitButton_Click"
runat="server"/>
</td>
</tr>
</table>
<br /><br />
<span id="Message"
runat="Server"/>
</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">
<script runat="server">
Sub SubmitButton_Click(ByVal sender As Object, ByVal e As EventArgs)
' Determine which button was clicked.
Select Case (CType(sender, HtmlInputButton)).ID
Case "CityQueryButton"
' Take the appropriate action if the controls pass validation.
If CityReqValidator.IsValid Then
Message.InnerHtml = "You have chosen to run a query for the following city: " & _
CityTextBox.Value
End If
Case "StateQueryButton"
' Take the appropriate action if the controls pass validation.
If StateReqValidator.IsValid Then
Message.InnerHtml = "You have chosen to run a query for the following state: " & _
StateTextBox.Value
End If
Case Else
' If the button clicked is not recognized, erase the message on the page.
Message.InnerHtml = ""
End Select
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>HtmlInputButton ValidationGroup Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3> HtmlInputButton ValidationGroup Example </h3>
<table border="1" cellpadding="10">
<tr>
<td>
<b>Enter city to query.</b> <br />
<input id="CityTextBox"
type="Text"
runat="server"/>
<asp:RequiredFieldValidator ID="CityReqValidator"
ControlToValidate="CityTextBox"
ValidationGroup="CityInfoGroup"
ErrorMessage="<br />Please enter a city."
Display="Dynamic"
EnableClientScript="False"
runat="server"/>
</td>
<td valign="bottom">
<input id="CityQueryButton"
type="Submit"
value="Submit"
causesvalidation="True"
validationgroup="CityInfoGroup"
onserverclick="SubmitButton_Click"
runat="server"/>
</td>
</tr>
<tr>
<td>
<b>Enter state to query.</b> <br />
<input id="StateTextBox"
type="Text"
runat="server"/>
<asp:RequiredFieldValidator ID="StateReqValidator"
ControlToValidate="StateTextBox"
ValidationGroup="StateInfoGroup"
ErrorMessage="<br />Please enter a state."
Display="Dynamic"
EnableClientScript="False"
runat="server"/>
</td>
<td valign="bottom">
<input id="StateQueryButton"
type="Submit"
value="Submit"
causesvalidation="True"
validationgroup="StateInfoGroup"
onserverclick="SubmitButton_Click"
runat="server"/>
</td>
</tr>
</table>
<br /><br />
<span id="Message"
runat="Server"/>
</form>
</body>
</html>
備註
驗證群組可讓您將頁面上的驗證控制項指派給特定類別。 每個驗證群組都可以獨立于頁面上的其他驗證群組進行驗證。 ValidationGroup使用 屬性可指定控制項在回傳至伺服器時造成驗證的驗證組 HtmlInputButton 名。
只有當 屬性的值設定為 true 時， CausesValidation 這個屬性才會生效。 當您指定 屬性的值 ValidationGroup 時，只有在控制項回傳至伺服器時 HtmlInputButton ，才會驗證屬於指定群組一部分的驗證控制項。 如果您未指定這個屬性的值，而且 CausesValidation 屬性設定為 true ，則控制項回傳至伺服器時，會驗證頁面上未指派給驗證群組的所有驗證控制項。