Button.ValidationGroup Propriété

Définition

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

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; }
[<System.Web.UI.Themeable(false)>]
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 Button provoque la validation lors de la publication sur le serveur.The group of controls for which the Button control causes validation when it posts back to the server. La valeur par défaut est une chaîne vide ("").The default value is an empty string ("").

Implémente

Attributs

Exemples

L’exemple de code suivant montre comment utiliser la ValidationGroup propriété pour spécifier les contrôles à valider lorsqu’un Button 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 a Button control posts back to the server. La page contient trois zones de texte pour capturer les données de l’utilisateur et trois RequiredFieldValidator contrôles pour s’assurer que l’utilisateur ne laisse pas de zone de texte vide.The page contains three text boxes to capture data from the user and three RequiredFieldValidator controls to ensure that the user does not leave a text box blank. Les RequiredFieldValidator contrôles pour les deux premières zones de texte se trouvent dans le PersonalInfoGroup groupe de validation et le RequiredFieldValidator contrôle pour la troisième zone de texte se trouve dans le LocationInfoGroup groupe de validation.The RequiredFieldValidator controls for the first two text boxes are in the PersonalInfoGroup validation group and the RequiredFieldValidator control for the third text box is in the LocationInfoGroup validation group. Lorsque l' Button1 utilisateur clique sur, seuls les contrôles du groupe de validation PersonalInfoGroup sont validés.When Button1 is clicked, only the controls in validation group PersonalInfoGroup are validated. Lorsque l' Button2 utilisateur clique sur, seul le contrôle du groupe de validation LocationInfoGroup est validé.When Button2 is clicked, only the control in validation group LocationInfoGroup is validated.

Important

Cet exemple comprend une zone de texte qui accepte une entrée d'utilisateur, ce qui constitue une menace potentielle pour la sécurité.This example has a text box that accepts user input, which is a potential security threat. Par défaut, les pages web ASP.NET vérifient que l’entrée d’utilisateur n’inclut pas de script ou d’éléments HTML.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Pour plus d’informations, consultez Vue d’ensemble des attaques de script.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 id="head1" runat="server">
  <title>Button.ValidationGroup Example</title>
</head>
<body>
  <form id="form1" runat="server">
  
    <h3>Button.ValidationGroup Example</h3>

    <asp:label id="NameLabel" 
      text="Enter your name:"
      runat="Server"
      AssociatedControlID="NameTextBox">
    </asp:label>

    &nbsp;
    
    <asp:textbox id="NameTextBox" 
      runat="Server">
    </asp:textbox>

    &nbsp;

    <asp:requiredfieldvalidator id="RequiredFieldValidator1"
      controltovalidate="NameTextBox"
      validationgroup="PersonalInfoGroup"
      errormessage="Enter your name."
      runat="Server">
    </asp:requiredfieldvalidator>
    
    <br /><br />
    
    <asp:label id="AgeLabel" 
      text="Enter your age:"
      runat="Server" 
      AssociatedControlID="AgeTextBox">
    </asp:label>

    &nbsp;
    
    <asp:textbox id="AgeTextBox" 
      runat="Server">
    </asp:textbox>

    &nbsp;

    <asp:requiredfieldvalidator id="RequiredFieldValidator2"
      controltovalidate="AgeTextBox"
      validationgroup="PersonalInfoGroup"
      errormessage="Enter your age."
      runat="Server">
    </asp:requiredfieldvalidator>
    
    <br /><br />

    <!--When Button1 is clicked, only validation
    controls that are a part of PersonalInfoGroup
    are validated.-->
    <asp:button id="Button1" 
      text="Validate" 
      causesvalidation="true"
      validationgroup="PersonalInfoGroup"
      runat="Server" />
      
    <br /><br />
      
    <asp:label id="CityLabel" 
      text="Enter your city of residence:"
      runat="Server" 
      AssociatedControlID="CityTextBox">
    </asp:label>

    &nbsp;
    
    <asp:textbox id="CityTextBox" 
      runat="Server">
    </asp:textbox>

    &nbsp;

    <asp:requiredfieldvalidator id="RequiredFieldValidator3"
      controltovalidate="CityTextBox"
      validationgroup="LocationInfoGroup"
      errormessage="Enter a city name."
      runat="Server">
    </asp:requiredfieldvalidator>
    
    <br /><br />

    <!--When Button2 is clicked, only validation
    controls that are a part of LocationInfoGroup
    are validated.-->
    <asp:button id="Button2" 
      text="Validate" 
      causesvalidation="true"
      validationgroup="LocationInfoGroup"
      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>Button.ValidationGroup Example</title>
</head>
<body>
  <form id="form1" runat="server">
  
    <h3>Button.ValidationGroup Example</h3>

    <asp:label id="NameLabel" 
      text="Enter your name:"
      runat="Server"
      AssociatedControlID="NameTextBox">
    </asp:label>

    &nbsp;
    
    <asp:textbox id="NameTextBox" 
      runat="Server">
    </asp:textbox>

    &nbsp;

    <asp:requiredfieldvalidator id="RequiredFieldValidator1"
      controltovalidate="NameTextBox"
      validationgroup="PersonalInfoGroup"
      errormessage="Enter your name."
      runat="Server">
    </asp:requiredfieldvalidator>
    
    <br /><br />
    
    <asp:label id="AgeLabel" 
      text="Enter your age:"
      runat="Server"
      AssociatedControlID="AgeTextbox">
    </asp:label>

    &nbsp;
    
    <asp:textbox id="AgeTextbox" 
      runat="Server">
    </asp:textbox>

    &nbsp;

    <asp:requiredfieldvalidator id="RequiredFieldValidator2"
      controltovalidate="AgeTextBox"
      validationgroup="PersonalInfoGroup"
      errormessage="Enter your age."
      runat="Server">
    </asp:requiredfieldvalidator>
    
    <br /><br />

    <!--When Button1 is clicked, only validation
    controls that are a part of PersonalInfoGroup
    are validated.-->
    <asp:button id="Button1" 
      text="Validate" 
      causesvalidation="true"
      validationgroup="PersonalInfoGroup"
      runat="Server" />
      
    <br /><br />
      
    <asp:label id="CityLabel" 
      text="Enter your city of residence:"
      runat="Server"
       AssociatedControlID="CityTextbox">
    </asp:label>

    &nbsp;
    
    <asp:textbox id="CityTextbox" 
      runat="Server">
    </asp:textbox>

    &nbsp;

    <asp:requiredfieldvalidator id="RequiredFieldValidator3"
      controltovalidate="CityTextBox"
      validationgroup="LocationInfoGroup"
      errormessage="Enter a city name."
      runat="Server">
    </asp:requiredfieldvalidator>
    
    <br /><br />

    <!--When Button2 is clicked, only validation
    controls that are a part of LocationInfoGroup
    are validated.-->
    <asp:button id="Button2" 
      text="Validate" 
      causesvalidation="true"
      validationgroup="LocationInfoGroup"
      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 of other validation groups on the page. Utilisez la ValidationGroup propriété pour spécifier le nom du groupe de validation pour lequel le Button 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 Button 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 Button 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 Button 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.

Cette propriété ne peut pas être définie par les thèmes ou les thèmes de feuille de style.This property cannot be set by themes or style sheet themes. Pour plus d’informations, consultez ThemeableAttribute et thèmes et apparences ASP.net.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

S’applique à

Voir aussi