HtmlInputButton.ValidationGroup Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta il gruppo di controlli per il quale il controllo HtmlInputButton causa la convalida in occasione del postback al 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 StringValore della proprietà
Gruppo di controlli per il quale il controllo HtmlInputButton causa la convalida in occasione del postback al server. Il valore predefinito è una stringa vuota (""), che indica che questa proprietà non è impostata.
Esempio
Nell'esempio di codice seguente viene illustrato come utilizzare la ValidationGroup proprietà per specificare i controlli da convalidare quando un HtmlInputButton controllo esegue il postback al server. La pagina contiene due caselle di testo per acquisire dati dall'utente e due RequiredFieldValidator controlli per assicurarsi che l'utente non lasci vuota una casella di testo. Il RequiredFieldValidator controllo per la prima casella di testo si trova nel CityInfoGroup gruppo di convalida e il RequiredFieldValidator controllo per la seconda casella si trova nel StateInfoGroup gruppo di convalida. Quando si CityQueryButton fa clic su , viene convalidato solo il controllo nel CityInfoGroup gruppo di convalida. Quando si StateQueryButton fa clic su , viene convalidato solo il controllo nel StateInfoGroup gruppo di convalida.
<%@ 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>
Commenti
I gruppi di convalida consentono di assegnare controlli di convalida in una pagina a una categoria specifica. Ogni gruppo di convalida può essere convalidato indipendentemente da altri gruppi di convalida nella pagina. Utilizzare la ValidationGroup proprietà per specificare il nome del gruppo di convalida per il quale il controllo causa la HtmlInputButton convalida quando esegue il postback al server.
Questa proprietà ha un effetto solo quando il valore della CausesValidation proprietà è impostato su true. Quando si specifica un valore per la ValidationGroup proprietà, solo i controlli di convalida che fanno parte del gruppo specificato vengono convalidati quando il controllo esegue il HtmlInputButton postback al server. Se non si specifica un valore per questa proprietà e la CausesValidation proprietà è impostata su true, tutti i controlli di convalida nella pagina non assegnati a un gruppo di convalida vengono convalidati quando il controllo esegue il postback al server.
