HtmlInputButton.ValidationGroup Propriété

Définition

Obtient ou définit le groupe de contrôles pour lequel le HtmlInputButton provoque la validation lors de la publication sur le serveur.Gets or sets the group of controls for which the HtmlInputButton causes validation when it posts back to the server.

public:
 virtual property System::String ^ ValidationGroup { System::String ^ get(); void set(System::String ^ value); };
public virtual string ValidationGroup { get; set; }
member this.ValidationGroup : string with get, set
Public Overridable Property ValidationGroup As String

Valeur de propriété

String

Groupe de contrôles dont le contrôle HtmlInputButton provoque la validation lors de la publication sur le serveur.The group of controls for which the HtmlInputButton control causes validation when it posts back to the server. La valeur par défaut est une chaîne vide (""), ce qui signifie que cette propriété n'est pas définie.The default value is an empty string (""), indicating that this property is not set.

Exemples

L’exemple de code suivant montre comment utiliser la ValidationGroup propriété pour spécifier les contrôles à valider lorsqu’un HtmlInputButton contrôle effectue une publication sur le serveur.The following code example demonstrates how to use the ValidationGroup property to specify the controls to validate when an HtmlInputButton control posts back to the server. La page contient deux zones de texte pour capturer les données de l’utilisateur et deux RequiredFieldValidator contrôles pour s’assurer que l’utilisateur ne laisse pas de zone de texte vide.The page contains two text boxes to capture data from the user and two RequiredFieldValidator controls to ensure that the user does not leave a text box blank. Le RequiredFieldValidator contrôle de la première zone de texte se trouve dans le CityInfoGroup groupe de validation et le RequiredFieldValidator contrôle de la deuxième zone se trouve dans le StateInfoGroup groupe de validation.The RequiredFieldValidator control for the first text box is in the CityInfoGroup validation group and the RequiredFieldValidator control for the second box is in the StateInfoGroup validation group. Quand l' CityQueryButton utilisateur clique sur le, seul le contrôle du CityInfoGroup groupe de validation est validé.When the CityQueryButton is clicked, only the control in the CityInfoGroup validation group is validated. Quand l' StateQueryButton utilisateur clique sur le, seul le contrôle du StateInfoGroup groupe de validation est validé.When the StateQueryButton is clicked, only the control in the StateInfoGroup validation group is validated.

<%@ 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 (((HtmlInputButton)sender).ID)
    {

      case "CityQueryButton":

        // Take the appropriate action if the controls pass validation. 
        if (CityReqValidator.IsValid)
        {
          Message.InnerHtml = "You have chosen to run a query for the following city: " +
             CityTextBox.Value;
        }

        break;

      case "StateQueryButton":

        // Take the appropriate action if the controls pass validation.
        if (StateReqValidator.IsValid)
        {
          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>HtmlInputButton ValidationGroup Example</title>
</head>

<body>

   <form id="form1" runat="server">

      <h3> HtmlInputButton 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="<br />Please enter a city."
                    Display="Dynamic"
                    EnableClientScript="False"
                    runat="server"/>
            </td>
            <td valign="bottom">
               <input id="CityQueryButton"
                      type="Submit"
                      value="Submit"
                      causesvalidation="True"
                      validationgroup="CityInfoGroup" 
                      onserverclick="SubmitButton_Click"
                      runat="server"/>
            </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="<br />Please enter a state."
                    Display="Dynamic"
                    EnableClientScript="False"
                    runat="server"/>
            </td>
            <td valign="bottom">
               <input id="StateQueryButton"
                      type="Submit"
                      value="Submit"
                      causesvalidation="True"
                      validationgroup="StateInfoGroup"
                      onserverclick="SubmitButton_Click"
                      runat="server"/>
            </td>
         </tr>

      </table>

      <br /><br />

      <span id="Message"
            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">

<script runat="server">
  
  Sub SubmitButton_Click(ByVal sender As Object, ByVal e As EventArgs)
         
    ' Determine which button was clicked.
    Select Case (CType(sender, HtmlInputButton)).ID

      Case "CityQueryButton"

        ' Take the appropriate action if the controls pass validation. 
        If CityReqValidator.IsValid Then
           
          Message.InnerHtml = "You have chosen to run a query for the following city: " & _
             CityTextBox.Value
               
        End If

      Case "StateQueryButton"

        ' Take the appropriate action if the controls pass validation.
        If StateReqValidator.IsValid Then
               
          Message.InnerHtml = "You have chosen to run a query for the following state: " & _
             StateTextBox.Value
               
        End If

      Case Else

        ' If the button clicked is not recognized, erase the message on the page.
        Message.InnerHtml = ""

    End Select
        
  End Sub

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HtmlInputButton ValidationGroup Example</title>
</head>

<body>
   <form id="form1" runat="server">
      <h3> HtmlInputButton 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="<br />Please enter a city."
                    Display="Dynamic"
                    EnableClientScript="False"
                    runat="server"/>
            </td>
            <td valign="bottom">
               <input id="CityQueryButton"
                      type="Submit"
                      value="Submit"
                      causesvalidation="True"
                      validationgroup="CityInfoGroup"
                      onserverclick="SubmitButton_Click"
                      runat="server"/>
            </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="<br />Please enter a state."
                    Display="Dynamic"
                    EnableClientScript="False"
                    runat="server"/>
            </td>
            <td valign="bottom">
               <input id="StateQueryButton"
                      type="Submit"
                      value="Submit"
                      causesvalidation="True"
                      validationgroup="StateInfoGroup"
                      onserverclick="SubmitButton_Click"
                      runat="server"/>
            </td>
         </tr>

      </table>

      <br /><br />

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


   </form>
</body>
</html>

Remarques

Les groupes de validation vous permettent d’assigner des contrôles de validation sur une page à une catégorie spécifique.Validation groups allow you to assign validation controls on a page to a specific category. Chaque groupe de validation peut être validé indépendamment des autres groupes de validation sur la page.Each validation group can be validated independently from other validation groups on the page. Utilisez la ValidationGroup propriété pour spécifier le nom du groupe de validation pour lequel le HtmlInputButton contrôle provoque la validation lors de la publication sur le serveur.Use the ValidationGroup property to specify the name of the validation group for which the HtmlInputButton control causes validation when it posts back to the server.

Cette propriété a un effet uniquement lorsque la valeur de la CausesValidation propriété est définie sur true .This property has an effect only when the value of the CausesValidation property is set to true. Lorsque vous spécifiez une valeur pour la ValidationGroup propriété, seuls les contrôles de validation qui font partie du groupe spécifié sont validés lorsque le HtmlInputButton contrôle est publié sur le serveur.When you specify a value for the ValidationGroup property, only the validation controls that are part of the specified group are validated when the HtmlInputButton control posts back to the server. Si vous ne spécifiez pas de valeur pour cette propriété et CausesValidation que la propriété a la valeur true , tous les contrôles de validation de la page qui ne sont pas assignés à un groupe de validation sont validés lorsque le contrôle est publié sur le serveur.If you do not specify a value for this property and the CausesValidation property is set to true, all validation controls on the page that are not assigned to a validation group are validated when the control posts back to the server.

S’applique à

Voir aussi