ImageButton.ValidationGroup Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece el grupo de controles para los que el control ImageButton ejecuta la validación cuando realiza devoluciones al servidor.
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, setPublic Overridable Property ValidationGroup As StringValor de propiedad
Grupo de controles para los que el control ImageButton ejecuta la validación cuando realiza devoluciones al servidor. El valor predeterminado es una cadena vacía ("").
Implementaciones
- Atributos
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar la ValidationGroup propiedad para especificar los controles que se van a validar cuando un ImageButton control vuelve a conectarse al servidor. La página contiene tres cuadros de texto para capturar datos del usuario y tres RequiredFieldValidator controles para asegurarse de que el usuario no deja un cuadro de texto en blanco. Los RequiredFieldValidator controles de los dos primeros cuadros de texto están en el PersonalInfoGroup grupo de validación y el RequiredFieldValidator control del tercer cuadro de texto está en el grupo de LocationInfoGroup validación. Cuando ImageButton1 se hace clic en , solo se validan los controles del grupo PersonalInfoGroup de validación. Cuando ImageButton2 se hace clic en , solo se valida el control del grupo LocationInfoGroup de validación.
<%@ 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>ImageButton.ValidationGroup Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>ImageButton.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 ImageButton1 is clicked, only validation
controls that are a part of PersonalInfoGroup
are validated.-->
<asp:imagebutton id="ImageButton1"
alternatetext="Validate PersonalInfoGroup controls"
imageurl="Images/ImageButton1.JPG"
causesvalidation="true"
validationgroup="PersonalInfoGroup"
runat="Server" />
<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 ImageButton2 is clicked, only validation
controls that are a part of LocationInfoGroup
are validated.-->
<asp:imagebutton id="ImageButton2"
alternatetext="Validate LocationInfoGroup controls"
imageUrl="Images/ImageButton2.JPG"
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 id="head1" runat="server">
<title>ImageButton.ValidationGroup Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>ImageButton.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 ImageButton1 is clicked, only validation
controls that are a part of PersonalInfoGroup
are validated.-->
<asp:imagebutton id="ImageButton1"
alternatetext="Validate PersonalInfoGroup controls"
imageurl="Images/ImageButton1.JPG"
causesvalidation="true"
validationgroup="PersonalInfoGroup"
runat="Server" />
<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 ImageButton2 is clicked, only validation
controls that are a part of LocationInfoGroup
are validated.-->
<asp:imagebutton id="ImageButton2"
alternatetext="Validate LocationInfoGroup controls"
imageUrl="Images/ImageButton2.JPG"
causesvalidation="true"
validationgroup="LocationInfoGroup"
runat="Server" />
</form>
</body>
</html>
Comentarios
Los grupos de validación permiten asignar controles de validación en una página a una categoría específica. Cada grupo de validación se puede validar independientemente de otros grupos de validación de la página. Utilice la ValidationGroup propiedad para especificar el nombre del grupo de validación para el que el control hace que la ImageButton validación se envíe al servidor. Esta propiedad solo tiene un efecto cuando el valor de la CausesValidation propiedad se establece en true. Cuando se especifica un valor para la ValidationGroup propiedad , solo se validan los controles de validación que forman parte del grupo especificado cuando el ImageButton control vuelve a conectarse al servidor. Si no especifica un valor para esta propiedad y la CausesValidation propiedad se establece trueen , todos los controles de validación de la página que no están asignados a un grupo de validación se validan cuando el control vuelve a colocar en el servidor.
Esta propiedad no se puede establecer mediante temas o temas de la hoja de estilos. Para obtener más información, consulte ThemeableAttribute y ASP.NET Temas y máscaras.
Se aplica a
Consulte también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de