LinkButton.ValidationGroup, propriété
Assembly : System.Web (dans system.web.dll)
/** @property */ public String get_ValidationGroup () /** @property */ public void set_ValidationGroup (String value)
public function get ValidationGroup () : String public function set ValidationGroup (value : String)
Non applicable.
Valeur de la propriété
Groupe de contrôles dont le contrôle LinkButton provoque la validation lors de la publication sur le serveur. La valeur par défaut est une chaîne vide ("").Les groupes de validation vous permettent d'assigner des contrôles de validation sur une page à une catégorie spécifique. Chaque groupe de validation peut être validé indépendamment des autres groupes de validation de la page. Utilisez la propriété ValidationGroup pour spécifier le nom du groupe de validation pour lequel le contrôle LinkButton provoque la validation lors de la publication sur le serveur.
Cette propriété n'a d'effet que lorsque la valeur de la propriété CausesValidation est true. Lorsque vous spécifiez une valeur pour la propriété ValidationGroup, seuls les contrôles de validation qui appartiennent au groupe spécifié sont validés lorsque le contrôle LinkButton est publié sur le serveur. Si vous ne spécifiez pas de valeur pour cette propriété et que la propriété CausesValidation 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.
Cette propriété ne peut pas être définie par les thèmes ou les thèmes de feuille de style. Pour plus d'informations, consultez ThemeableAttribute et Vue d'ensemble des thèmes et des apparences ASP.NET.
L'exemple de code suivant montre comment utiliser la propriété ValidationGroup pour spécifier les contrôles devant être validés quand un contrôle LinkButton effectue une publication sur le serveur. La page contient trois zones de texte pour capturer les données de l'utilisateur et trois contrôles RequiredFieldValidator pour garantir que l'utilisateur ne laisse pas une zone de texte vide. Les contrôles RequiredFieldValidator pour les deux premières zones de texte se trouvent dans le groupe de validation PersonalInfoGroup et les contrôles RequiredFieldValidator pour la troisième zone de texte sont situés dans le groupe de validation LocationInfoGroup. Lorsqu'un clic est effectué sur LinkButton1, seuls les contrôles du groupe de validation PersonalInfoGroup sont validés. Lorsqu'un clic est effectué sur LinkButton2, seul le contrôle du groupe de validation LocationInfoGroup est validé.
 Remarque : de sécurité |
|---|
| Cet exemple comprend une zone de texte qui accepte une entrée d'utilisateur, ce qui constitue une menace potentielle pour la sécurité. Par défaut, les pages Web ASP.NET vérifient que l'entrée d'utilisateur n'inclut pas de script ni d'éléments HTML. Pour plus d'informations, consultez Vue d'ensemble des attaques de script. |
<%@ 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>LinkButton.ValidationGroup Example</title> </head> <body> <form id="form1" runat="server"> <h3>LinkButton.ValidationGroup Example</h3> <asp:label id="NameLabel" text="Enter your name:" runat="Server" AssociatedControlID="NameTextBox"> </asp:label>   <asp:textbox id="NameTextBox" runat="Server"> </asp:textbox>   <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>   <asp:textbox id="AgeTextBox" runat="Server"> </asp:textbox>   <asp:requiredfieldvalidator id="RequiredFieldValidator2" controltovalidate="AgeTextBox" validationgroup="PersonalInfoGroup" errormessage="Enter your age." runat="Server"> </asp:requiredfieldvalidator> <br /><br /> <!--When LinkButton1 is clicked, only validation controls that are a part of PersonalInfoGroup are validated.--> <asp:linkbutton id="LinkButton1" text="Validate" causesvalidation="true" validationgroup="PersonalInfoGroup" runat="Server"> </asp:linkbutton> <br /><br /> <asp:label id="CityLabel" text="Enter your city of residence:" runat="Server" AssociatedControlID="CityTextBox"> </asp:label>   <asp:textbox id="CityTextBox" runat="Server"> </asp:textbox>   <asp:requiredfieldvalidator id="RequiredFieldValidator3" controltovalidate="CityTextBox" validationgroup="LocationInfoGroup" errormessage="Enter a city name." runat="Server"> </asp:requiredfieldvalidator> <br /><br /> <!--When LinkButton2 is clicked, only validation controls that are a part of LocationInfoGroup are validated.--> <asp:linkbutton id="LinkButton2" text="Validate" causesvalidation="true" validationgroup="LocationInfoGroup" runat="Server"> </asp:linkbutton> </form> </body> </html>
Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition
Microsoft .NET Framework 3.0 est pris en charge sur Windows Vista, Microsoft Windows XP SP2 et Windows Server 2003 SP1.