Прочитать на английском

Поделиться через

HtmlButton.ValidationGroup Свойство

Определение

Пространство имен:
System.Web.UI.HtmlControls
Сборка:
System.Web.dll

Получает или задает группу элементов управления, для которых объект HtmlButton инициирует проверку при обратной передаче на сервер.

C# 
public virtual string ValidationGroup { get; set; }

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

String

Группа элементов управления, для которых элемент управления HtmlButton инициирует проверку при обратной передаче на сервер. Значение по умолчанию представляет собой пустую строку (""), показывающую, что значение свойства не задано.

Примеры

В следующем примере кода показано, как использовать ValidationGroup свойство , чтобы указать элементы управления для проверки, когда HtmlButton элемент управления отправляет обратно на сервер. Страница содержит два текстовых поля для сбора данных от пользователя и два RequiredFieldValidator элемента управления, чтобы пользователь не оставил текстовое поле пустым. Элемент RequiredFieldValidator управления для первого текстового поля находится в CityInfoGroup группе проверки, а RequiredFieldValidator элемент управления для второго поля — в StateInfoGroup группе проверки. При щелчке CityQueryButton проверяется только элемент управления в CityInfoGroup группе проверки. При щелчке StateQueryButton проверяется только элемент управления в StateInfoGroup группе проверки.

ASP.NET (C#) 
<%@ Page Language="C#" %>

<!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, EventArgs e)
  {
    // Determine which button was clicked.
    switch (((HtmlButton)sender).ID)
    {
        
      case "CityQueryButton":

          if (CityReqValidator.IsValid)
          {
              // Indicate that the city query was selected.
              Message.InnerHtml = "You have chosen to run a query for the following city: " +
                                  CityTextBox.Value;
          }
        
        break;
        
      case "StateQueryButton":

          if (StateReqValidator.IsValid)
          {
              // Indicate that the state query was selected.
              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 runat="server">
    <title>HtmlButton ValidationGroup Example</title>
</head>
<body>
    <form id="form1" runat="server">    
    
        <h3>HtmlButton ValidationGroup 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="Please enter a city."
                      Display="Dynamic"
                      EnableClientScript="False"
                      runat="server"/>
                    
            </td>
            <td valign="bottom">
            
               <button id="CityQueryButton"
                       causesvalidation="True" 
                       validationgroup="CityInfoGroup" 
                       onserverclick="SubmitButton_Click"
                       runat="server">
                       Submit
               </button>
               
            </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="Please enter a state."
                      Display="Dynamic"
                      EnableClientScript="False"
                      runat="server"/>
                      
            </td>
            <td valign="bottom">
            
               <button id="StateQueryButton"
                       causesvalidation="True"
                       validationgroup="StateInfoGroup"
                       onserverclick="SubmitButton_Click"
                       runat="server">
                       Submit
               </button>
               
            </td>
         </tr>

      </table>

      <br /><br />

      <span id="Message"
            runat="Server"/>
    </form>
    
</body>

</html>

Комментарии

Группы проверки позволяют назначать элементы управления проверкой на странице определенной категории. Каждую группу проверки можно проверить независимо от других групп проверки на странице. Используйте свойство , ValidationGroup чтобы указать имя группы проверки, для которой HtmlButton элемент управления вызывает проверку при отправке обратно на сервер.

Это свойство действует только в том случае, если для свойства задано значение CausesValidationtrue. При указании значения свойства ValidationGroup проверяются только элементы управления проверки, которые входят в указанную группу, когда HtmlButton элемент управления отправляет обратно на сервер. Если значение этого свойства не указано, а свойству CausesValidation присвоено значение true, все элементы управления проверкой на странице, которые не назначены группе проверки, проверяются при возврате элемента управления на сервер.

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

Продукт Версии
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

См. также раздел