HtmlInputImage.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.
Ruft die Gruppe von Steuerelementen ab, für die das HtmlInputImage-Steuerelement eine Validierung erfordert, wenn es Daten an den Server zurücksendet, oder legt diese fest.
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, set
Public Overridable Property ValidationGroup As String
Eigenschaftswert
Die Gruppe von Steuerelementen, für die das HtmlInputImage-Steuerelement eine Validierung erfordert, wenn es Daten an den Server zurücksendet. Der Standardwert ist eine leere Zeichenfolge (""), die angibt, dass diese Eigenschaft nicht festgelegt wurde.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie Sie die ValidationGroup Eigenschaft verwenden, um die Steuerelemente anzugeben, um zu überprüfen, wann ein HtmlInputImage Steuerelement wieder auf den Server zurückgibt. Die Seite enthält zwei Textfelder zum Erfassen von Daten aus dem 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
Validierungsgruppe, und das RequiredFieldValidator Steuerelement für das zweite Feld befindet sich in der StateInfoGroup
Validierungsgruppe. Wenn der CityQueryButton
Klick erfolgt, wird nur das Steuerelement in der CityInfoGroup
Validierungsgruppe überprüft. Wenn der StateQueryButton
Klick erfolgt, wird nur das Steuerelement in der StateInfoGroup
Validierungsgruppe überprüft.
<%@ Page Language="C#" AutoEventWireup="True" %>
<!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, ImageClickEventArgs e)
{
// Determine which button was clicked.
switch (((HtmlInputImage)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>
<title> HtmlInputImage CausesValidation Example </title>
</head>
<body>
<form id="form1" runat="server">
<h3> HtmlInputImage 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="<br />Please enter a city."
Display="Dynamic"
EnableClientScript="False"
runat="server"/>
</td>
<td valign="bottom">
<input id="CityQueryButton"
alt="City Submit button"
type="Image"
src="Image.jpg"
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"
alt="State Submit button"
type="Image"
src="Image.jpg"
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" AutoEventWireup="True" %>
<!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 ImageClickEventArgs)
' Determine which button was clicked.
Select Case (CType(sender, HtmlInputImage)).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>
<title> HtmlInputImage CausesValidation Example </title>
</head>
<body>
<form id="form1" runat="server">
<h3> HtmlInputImage 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="<br />Please enter a city."
Display="Dynamic"
EnableClientScript="False"
runat="server"/>
</td>
<td valign="bottom">
<input id="CityQueryButton"
alt="City Submit button"
type="Image"
src="Image.jpg"
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"
alt="State Submit button"
type="Image"
src="Image.jpg"
causesvalidation="True"
validationgroup="StateInfoGroup"
onserverclick="SubmitButton_Click"
runat="server"/>
</td>
</tr>
</table>
<br /><br />
<span id="Message"
runat="Server"/>
</form>
</body>
</html>
Hinweise
Überprüfungsgruppen ermöglichen ihnen das Zuweisen von Überprüfungssteuerelementen auf einer Seite zu einer bestimmten Kategorie. Jede Validierungsgruppe 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 HtmlInputImage Steuerelement die Überprüfung verursacht, wenn sie wieder auf den Server zurückgibt.
Diese Eigenschaft hat nur einen Effekt, wenn der Wert der CausesValidation Eigenschaft auf true
" festgelegt ist. Wenn Sie einen Wert für die ValidationGroup Eigenschaft angeben, werden nur die Überprüfungssteuerelemente, die Teil der angegebenen Gruppe sind, überprüft, wenn die HtmlInputImage Steuerelementbeiträge wieder auf den Server zurückkommen. Wenn Sie keinen Wert für diese Eigenschaft angeben und die CausesValidation Eigenschaft auf "" festgelegt true
ist, werden alle Überprüfungssteuerelemente auf der Seite, die keiner Validierungsgruppe zugewiesen sind, überprüft, wenn das Steuerelement wieder auf den Server zurückgibt.