BaseValidator.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 den Namen der Validierungsgruppe ab, zu der dieses Validierungssteuerelement gehört, oder legt den Namen fest.
public:
virtual property System::String ^ ValidationGroup { System::String ^ get(); void set(System::String ^ value); };
[System.Web.UI.Themeable(false)]
public virtual string ValidationGroup { get; set; }
[<System.Web.UI.Themeable(false)>]
member this.ValidationGroup : string with get, set
Public Overridable Property ValidationGroup As String
Eigenschaftswert
Der Name der Validierungsgruppe, zu der dieses Validierungssteuerelement gehört. Der Standardwert ist eine leere Zeichenfolge ("") und gibt an, dass diese Eigenschaft nicht festgelegt ist.
- Attribute
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie Die ValidationGroup -Eigenschaft verwendet wird, um einer Gruppe ein Validierungssteuerelement zuzuweisen.
Wichtig
Dieses Beispiel umfasst ein Textfeld, das Benutzereingaben akzeptiert, die ein potenzielles Sicherheitsrisiko darstellen. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>BaseValidator ValidationGroup Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>BaseValidator ValidationGroup Example</h3>
Please enter your name:<br/>
<asp:textbox id="NameTextBox"
runat="server"/>
<asp:requiredfieldvalidator id="NameTextBoxRequiredValidator"
controltovalidate="NameTextBox"
display="Dynamic"
text="Please enter your name."
validationgroup="UserInfoGroup"
runat="server"/>
<br /><br />
<asp:button id="SubmitButton"
text="Submit"
validationgroup="UserInfoGroup"
runat="server"/>
<hr/>
Please enter a search topic:<br/>
<asp:textbox id="SearchTextBox"
runat="server"/>
<asp:requiredfieldvalidator id="SearchTextBoxRequiredValidator"
controltovalidate="SearchTextBox"
display="Dynamic"
text="Please enter a topic."
validationgroup="SearchGroup"
runat="server"/>
<br /><br />
<asp:button id="SearchButton"
text="Search"
validationgroup="SearchGroup"
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">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>BaseValidator ValidationGroup Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>BaseValidator ValidationGroup Example</h3>
Please enter your name:<br/>
<asp:textbox id="NameTextBox"
runat="server"/>
<asp:requiredfieldvalidator id="NameTextBoxRequiredValidator"
controltovalidate="NameTextBox"
display="Dynamic"
text="Please enter your name."
validationgroup="UserInfoGroup"
runat="server"/>
<br /><br />
<asp:button id="SubmitButton"
text="Submit"
validationgroup="UserInfoGroup"
runat="server"/>
<hr/>
Please enter a search topic:<br/>
<asp:textbox id="SearchTextBox"
runat="server"/>
<asp:requiredfieldvalidator id="SearchTextBoxRequiredValidator"
controltovalidate="SearchTextBox"
display="Dynamic"
text="Please enter a topic."
validationgroup="SearchGroup"
runat="server"/>
<br /><br />
<asp:button id="SearchButton"
text="Search"
validationgroup="SearchGroup"
runat="server"/>
</form>
</body>
</html>
Hinweise
ASP.NET bietet viele Steuerelemente, die die Möglichkeit haben, einen Postback an den Server zu senden. Wenn für eines dieser Steuerelemente seine CausesValidation
Eigenschaft auf true
festgelegt ist, wird die Überprüfung ausgeführt, wenn das Steuerelement an den Server zurückgibt. Die folgenden Steuerelemente verfügen über die Möglichkeit, eine Postrückveröffentlichung auf dem Server auszuführen:
Hinweis
Einige dieser Steuerelemente werden nur dann an den Server zurückgesetzt, wenn die AutoPostBack
Eigenschaft auf true
festgelegt ist.
Diese Steuerelemente verfügen jeweils über eine ValidationGroup
Eigenschaft, die, wenn festgelegt, nur die Validierungssteuerelemente innerhalb der angegebenen Gruppe überprüft, wenn das Steuerelement einen Postback an den Server auslöst. Verwenden Sie die ValidationGroup -Eigenschaft, um einer Validierungsgruppe ein Validierungssteuerelement zuzuweisen. Die Page -Klasse macht auch eine GetValidators -Methode und eine Validate -Methode verfügbar, die einen ValidationGroup Eingabeparameter akzeptieren.
Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET-Designs und Skins.