HtmlButton.ValidationGroup Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví skupinu ovládacích prvků, pro které HtmlButton způsobuje ověření při odeslání zpět na server.
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 StringHodnota vlastnosti
Skupina ovládacích prvků, pro které HtmlButton ovládací prvek způsobí ověření při odeslání zpět na server. Výchozí hodnota je prázdný řetězec ("") označující, že tato vlastnost není nastavena.
Příklady
Následující příklad kódu ukazuje, jak použít ValidationGroup vlastnost k určení ovládacích prvků k ověření, když ovládací HtmlButton prvek odešle zpět na server. Stránka obsahuje dvě textová pole pro zachycení dat od uživatele a dva RequiredFieldValidator ovládací prvky, které zajistí, že uživatel nenechá textové pole prázdné. Ovládací RequiredFieldValidator prvek prvního textového pole je ve CityInfoGroup skupině ověření a RequiredFieldValidator ovládací prvek pro druhé pole je ve skupině StateInfoGroup ověření. Po kliknutí na CityQueryButton tlačítko se ověří pouze ovládací prvek ve skupině CityInfoGroup ověřování. Po kliknutí na StateQueryButton tlačítko se ověří pouze ovládací prvek ve skupině StateInfoGroup ověřování.
<%@ 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>
Poznámky
Skupiny ověření umožňují přiřadit ovládací prvky ověřování na stránce ke konkrétní kategorii. Každou ověřovací skupinu je možné ověřit nezávisle na ostatních ověřovacích skupinách na stránce. ValidationGroup Pomocí vlastnosti zadejte název ověřovací skupiny, pro kterou HtmlButton ovládací prvek způsobí ověření při odeslání zpět na server.
Tato vlastnost má účinek pouze v případě, že je hodnota vlastnosti nastavena CausesValidation na truehodnotu . Když zadáte hodnotu vlastnosti ValidationGroup , ověří se HtmlButton při odeslání zpět na server pouze ověřovací ovládací prvky, které jsou součástí zadané skupiny. Pokud nezadáte hodnotu pro tuto vlastnost a CausesValidation vlastnost je nastavena na true, všechny ověřovací ovládací prvky na stránce, které nejsou přiřazeny ověřovací skupině, budou ověřeny, když ovládací prvek odešle zpět na server.
