HtmlInputButton.ValidationGroup Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает группу элементов управления, для которых объект 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 элемент управления вызывает проверку при отправке обратно на сервер.
Это свойство действует только в том случае, если для свойства задано значение CausesValidationtrue. При указании значения свойства ValidationGroup проверяются только элементы управления проверки, которые входят в указанную группу, когда HtmlInputButton элемент управления отправляет обратно на сервер. Если значение этого свойства не указано, а свойству CausesValidation присвоено значение true, все элементы управления проверкой на странице, которые не назначены группе проверки, проверяются при возврате элемента управления на сервер.
