BaseValidator.ValidationGroup BaseValidator.ValidationGroup BaseValidator.ValidationGroup BaseValidator.ValidationGroup Property

Определение

Получает или задает имя группы проверки, к которой принадлежит элемент управления проверки.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

Значение свойства

Имя группы проверки, к которой принадлежит элемент управления проверки.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.

Примеры

В следующем примере кода показано, как использовать ValidationGroup свойство для назначения проверочного элемента управления группе.The following code example demonstrates how to use the ValidationGroup property to assign a validation control to a group.

Важно!

В этом примере имеется текстовое поле, принимающее вводимые пользователем данные, что является потенциальной угрозой безопасности.This example has a text box that accepts user input, which is a potential security threat. По умолчанию данные, вводимые пользователем на веб-страницах ASP.NET, проверяются на наличие скриптов и HTML-элементов.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Дополнительные сведения см. в разделе Общие сведения об использовании сценариев.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>

Комментарии

ASP.NET предоставляет множество элементов управления, которые имеют возможность обратной передачи на сервер.ASP.NET provides many controls that have the ability to post back to the server. Если для CausesValidation trueодного из этих элементов управления свойство имеет значение, проверка выполняется при обратной передаче элемента управления на сервер.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:

Примечание

Некоторые из этих элементов управления AutoPostBack trueпередаются обратно на сервер, только если свойство имеет значение.Some of these controls post back to the server only when the AutoPostBack property is set to true.

Каждый из этих элементов управления ValidationGroup имеет свойство, которое при установке проверяет только элементы управления проверки в пределах указанной группы, когда элемент управления запускает обратную передачу на сервер.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. ValidationGroup Используйте свойство, чтобы назначить элемент управления проверки группе проверки.Use the ValidationGroup property to assign a validation control to a validation group. Класс также Validate предоставляет метод и метод, принимающие ValidationGroup входной параметр. GetValidators PageThe 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. Дополнительные сведения см ThemeableAttribute . в статьях и ASP.NET Themes и обложки.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

Применяется к

Дополнительно