BaseValidator.ValidationGroup Eigenschaft

Definition

Ruft den Namen der Validierungsgruppe ab, zu der dieses Validierungssteuerelement gehört, oder legt den Namen fest.Gets or sets the name of the validation group to which this validation control belongs.

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; }
member this.ValidationGroup : string with get, set
Public Overridable Property ValidationGroup As String

Eigenschaftswert

Der Name der Validierungsgruppe, zu der dieses Validierungssteuerelement gehört.The name of the validation group to which this validation control belongs. Der Standardwert ist eine leere Zeichenfolge ("") und gibt an, dass diese Eigenschaft nicht festgelegt ist.The default is an empty string (""), which indicates that this property is not set.

Attribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die ValidationGroup -Eigenschaft verwendet wird, um einer Gruppe ein Validierungs Steuerelement zuzuweisen.The following code example demonstrates how to use the ValidationGroup property to assign a validation control to a group.

Wichtig

Dieses Beispiel umfasst ein Textfeld, das Benutzereingaben akzeptiert, die ein potenzielles Sicherheitsrisiko darstellen.This example has a text box that accepts user input, which is a potential security threat. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.For more information, see Script Exploits Overview.

<%@ 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 zahlreiche Steuerelemente, die die Möglichkeit haben, zurück an den Server zu senden.ASP.NET provides many controls that have the ability to post back to the server. Wenn für eines dieser Steuerelemente CausesValidation die-Eigenschaft auf truefestgelegt ist, wird die Validierung ausgeführt, wenn das Steuerelement an den Server zurückgesendet wird.When one of these controls has its CausesValidation property set to true, validation is performed when the control posts back to server. Die folgenden Steuerelemente können an den Server zurückgesendet werden:The following controls have the ability to post back to the server:

Hinweis

Einige dieser Steuerelemente werden nur dann an den Server zurückgesendet AutoPostBack , wenn die- trueEigenschaft auf festgelegt ist.Some of these controls post back to the server only when the AutoPostBack property is set to true.

Diese Steuerelemente verfügen jeweils ValidationGroup über eine-Eigenschaft, die bei Festlegung nur die Validierungs Steuerelemente innerhalb der angegebenen Gruppe überprüft, wenn das Steuerelement ein Postback an den Server auslöst.These controls each have a ValidationGroup property that, when set, validates only the validation controls within the specified group when the control triggers a post back to the server. Verwenden Sie ValidationGroup die-Eigenschaft, um einer Validierungs Gruppe ein Validierungs Steuerelement zuzuweisen.Use the ValidationGroup property to assign a validation control to a validation group. Die Page -Klasse macht auch GetValidators eine-Methode Validate und eine-Methode ValidationGroup verfügbar, die einen Eingabeparameter akzeptieren.The Page class also exposes a GetValidators method and a Validate method that accept a ValidationGroup input parameter.

Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden.This property cannot be set by themes or style sheet themes. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET-Designs und Skins.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

Gilt für:

Siehe auch