HtmlButton.ValidationGroup Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает группу элементов управления, для которых объект HtmlButton инициирует проверку при обратной передаче на сервер.
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Значение свойства
Группа элементов управления, для которых элемент управления HtmlButton инициирует проверку при обратной передаче на сервер. Значение по умолчанию представляет собой пустую строку (""), показывающую, что значение свойства не задано.
Примеры
В следующем примере кода показано, как использовать ValidationGroup свойство для указания элементов управления, чтобы проверить, когда HtmlButton элемент управления отправляет обратно на сервер. Страница содержит два текстовых поля для записи данных от пользователя и двух 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 (((HtmlButton)sender).ID)
{
case "CityQueryButton":
if (CityReqValidator.IsValid)
{
// Indicate that the city query was selected.
Message.InnerHtml = "You have chosen to run a query for the following city: " +
CityTextBox.Value;
}
break;
case "StateQueryButton":
if (StateReqValidator.IsValid)
{
// Indicate that the state query was selected.
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>HtmlButton ValidationGroup Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HtmlButton 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="Please enter a city."
Display="Dynamic"
EnableClientScript="False"
runat="server"/>
</td>
<td valign="bottom">
<button id="CityQueryButton"
causesvalidation="True"
validationgroup="CityInfoGroup"
onserverclick="SubmitButton_Click"
runat="server">
Submit
</button>
</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="Please enter a state."
Display="Dynamic"
EnableClientScript="False"
runat="server"/>
</td>
<td valign="bottom">
<button id="StateQueryButton"
causesvalidation="True"
validationgroup="StateInfoGroup"
onserverclick="SubmitButton_Click"
runat="server">
Submit
</button>
</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, HtmlButton)).ID
Case "CityQueryButton"
If (CityReqValidator.IsValid) Then
' Indicate that the city query was selected.
Message.InnerHtml = "You have chosen to run a query for the following city: " & _
CityTextBox.Value
End If
Case "StateQueryButton"
If (StateReqValidator.IsValid) Then
' Indicate that the state query was selected.
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> HtmlButton CausesValidation Example </title>
</head>
<body>
<form id="form1" runat="server">
<h3> HtmlButton CausesValidation 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="Please enter a city."
Display="Dynamic"
EnableClientScript="False"
runat="server"/>
</td>
<td valign="bottom">
<button id="CityQueryButton"
causesvalidation="True"
validationgroup="CityInfoGroup"
onserverclick="SubmitButton_Click"
runat="server">
Submit
</button>
</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="Please enter a state."
Display="Dynamic"
EnableClientScript="False"
runat="server"/>
</td>
<td valign="bottom">
<button id="StateQueryButton"
causesvalidation="True"
validationgroup="StateInfoGroup"
onserverclick="SubmitButton_Click"
runat="server">
Submit
</button>
</td>
</tr>
</table>
<br /><br />
<span id="Message"
runat="Server"/>
</form>
</body>
</html>
Комментарии
Группы проверки позволяют назначать элементы управления проверки на странице определенной категории. Каждую группу проверки можно проверить независимо от других групп проверки на странице. ValidationGroup Используйте свойство, чтобы указать имя группы проверки, для которой HtmlButton элемент управления вызывает проверку при обратной отправке на сервер.
Это свойство действует только в том случае, если для свойства CausesValidation задано значение true. При указании значения для ValidationGroup свойства проверяются только элементы управления проверки, которые входят в указанную группу, при HtmlButton обратной отправке элементов управления на сервер. Если для этого свойства не указано значение, а CausesValidation для свойства задано значение true, все элементы управления проверки на странице, которые не назначены группе проверки, проверяются при обратной отправке элементов управления на сервер.