BaseValidator.ValidationGroup Property (System.Web.UI.WebControls)

ValidationGroup Property

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2010/.NET Framework 4

Other versions are also available for the following:

.NET Framework Class Library

BaseValidator..::.ValidationGroup Property

Gets or sets the name of the validation group to which this validation control belongs.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in System.Web.dll)

Syntax

Visual Basic

<ThemeableAttribute(False)> _
Public Overridable Property ValidationGroup As String

[ThemeableAttribute(false)]
public virtual string ValidationGroup { get; set; }

Visual C++

[ThemeableAttribute(false)]
public:
virtual property String^ ValidationGroup {
    String^ get ();
    void set (String^ value);
}

[<ThemeableAttribute(false)>]
abstract ValidationGroup : string with get, set
[<ThemeableAttribute(false)>]
override ValidationGroup : string with get, set

ASP.NET

<asp:BaseValidator ValidationGroup="String" />

Property Value

Type: System..::.String
The name of the validation group to which this validation control belongs. The default is an empty string (""), which indicates that this property is not set.

Remarks

ASP.NET provides many controls that have the ability to post back to the server. When one of these controls has its CausesValidation property set to true, validation is performed when the control posts back to server. The following controls have the ability to post back to the server:

Note
Some of these controls post back to the server only when the AutoPostBack property is set to true.

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. Use the ValidationGroup property to assign a validation control to a validation group. The Page class also exposes a GetValidators method and a Validate method that accept a ValidationGroup input parameter.

This property cannot be set by themes or style sheet themes. For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

Topic	Location
Walkthrough: Validating User Input in a Web Forms Page	Building ASP .NET Web Applications in Visual Studio

Examples

The following code example demonstrates how to use the ValidationGroup property to assign a validation control to a group.

Security Note
This example has a text box that accepts user input, which is a potential security threat. By default, ASP.NET Web pages validate that user input does not include script or HTML elements. For more information, see Script Exploits Overview.

Visual Basic

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html  >
  <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="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html  >
  <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>

Version Information

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Reference

BaseValidator Class

System.Web.UI.WebControls Namespace

IButtonControl..::.CausesValidation

IButtonControl..::.ValidationGroup

Validate

GetValidators