HtmlInputButton.ValidationGroup Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen der Gruppe von Steuerelementen, für die die HtmlInputButton Überprüfung verursacht wird, wenn sie auf den Server zurückgibt.
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 StringEigenschaftswert
Die Gruppe der Steuerelemente, für die das HtmlInputButton Steuerelement eine Überprüfung bewirkt, wenn es wieder auf dem Server veröffentlicht wird. Der Standardwert ist eine leere Zeichenfolge (""), die angibt, dass diese Eigenschaft nicht festgelegt ist.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie die ValidationGroup Eigenschaft verwendet wird, um die Steuerelemente anzugeben, die überprüft werden sollen, wenn ein HtmlInputButton Steuerelement wieder auf dem Server bereitgestellt wird. Die Seite enthält zwei Textfelder zum Erfassen von Daten vom Benutzer und zwei RequiredFieldValidator Steuerelemente, um sicherzustellen, dass der Benutzer kein Textfeld leer lässt. Das RequiredFieldValidator Steuerelement für das erste Textfeld befindet sich in der CityInfoGroup Überprüfungsgruppe, und das RequiredFieldValidator Steuerelement für das zweite Feld befindet sich in der StateInfoGroup Überprüfungsgruppe. Wenn auf die CityQueryButton Schaltfläche geklickt wird, wird nur das Steuerelement in der CityInfoGroup Überprüfungsgruppe überprüft. Wenn auf die StateQueryButton Schaltfläche geklickt wird, wird nur das Steuerelement in der StateInfoGroup Überprüfungsgruppe überprüft.
<%@ 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>
Hinweise
Mithilfe von Validierungsgruppen können Sie einer bestimmten Kategorie Überprüfungssteuerelemente auf einer Seite zuweisen. Jede Überprüfungsgruppe kann unabhängig von anderen Validierungsgruppen auf der Seite überprüft werden. Verwenden Sie die ValidationGroup Eigenschaft, um den Namen der Überprüfungsgruppe anzugeben, für die das HtmlInputButton Steuerelement eine Überprüfung verursacht, wenn sie wieder auf dem Server veröffentlicht wird.
Diese Eigenschaft hat nur dann auswirkungen, wenn der Wert der CausesValidation Eigenschaft auf true. Wenn Sie einen Wert für die ValidationGroup Eigenschaft angeben, werden nur die Überprüfungssteuerelemente überprüft, die Teil der angegebenen Gruppe sind, wenn das HtmlInputButton Steuerelement auf dem Server zurückgibt. Wenn Sie keinen Wert für diese Eigenschaft angeben und die CausesValidation Eigenschaft auf true festgelegt ist, werden alle Überprüfungssteuerelemente auf der Seite überprüft, die keiner Überprüfungsgruppe zugewiesen sind, wenn das Steuerelement wieder auf dem Server veröffentlicht wird.
