HtmlButton.ValidationGroup Tulajdonság
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Lekéri vagy beállítja azon vezérlők csoportját, amelyek esetében az HtmlButton ellenőrzés a kiszolgálóra való visszatéréskor jelentkezik.
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 StringTulajdonság értéke
Azon vezérlők csoportja, amelyek esetében a HtmlButton vezérlő érvényesítést okoz, amikor a kiszolgálóra való visszahelyezési művelet történik. Az alapértelmezett érték egy üres sztring (""), amely azt jelzi, hogy ez a tulajdonság nincs beállítva.
Példák
Az alábbi példakód bemutatja, hogyan használható a tulajdonság a ValidationGroup vezérlőknek a kiszolgálóra való visszatéréskor érvényesítendő HtmlButton vezérlők megadására. A lap két szövegdobozt tartalmaz a felhasználó adatainak rögzítéséhez, valamint két RequiredFieldValidator vezérlőt, hogy a felhasználó ne hagyjon üresen egy szövegdobozt. Az RequiredFieldValidator első szövegmező vezérlőeleme az CityInfoGroup érvényesítési csoportban, a RequiredFieldValidator második mező vezérlőeleme pedig az StateInfoGroup érvényesítési csoportban található.
CityQueryButton A kattintáskor csak az érvényesítési csoport vezérlőeleme CityInfoGroup lesz érvényesítve.
StateQueryButton A kattintáskor csak az érvényesítési csoport vezérlőeleme StateInfoGroup lesz érvényesítve.
<%@ 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>
Megjegyzések
Az érvényesítési csoportok lehetővé teszik, hogy egy lapon érvényesítési vezérlőket rendeljen egy adott kategóriához. Minden érvényesítési csoport a lap többi érvényesítési csoportjától függetlenül érvényesíthető. ValidationGroup A tulajdonság használatával adja meg annak az érvényesítési csoportnak a nevét, amelynek ellenőrzése a HtmlButton kiszolgálóra való visszatéréskor érvényesítést okoz.
Ennek a tulajdonságnak csak akkor van hatása, ha a CausesValidation tulajdonság értéke a következőre truevan állítva: . A tulajdonság értékének ValidationGroup megadásakor csak a megadott csoporthoz tartozó érvényesítési vezérlők lesznek érvényesítve, amikor a HtmlButton vezérlő visszahelyez a kiszolgálóra. Ha nem ad meg értéket ehhez a tulajdonsághoz, és a CausesValidation tulajdonság értéke be van állítva true, a rendszer ellenőrzi a lap azon érvényesítési vezérlőinek érvényességét, amelyek nincsenek érvényesítési csoporthoz rendelve, amikor a vezérlő visszahelyez a kiszolgálóra.
