BaseValidator.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 nombre del grupo de validación al que pertenece este control de validación.
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
Valor de propiedad
El nombre del grupo de validación al que pertenece este control de validación. El valor predeterminado es una cadena vacía (""), lo que indica que no se ha establecido esta propiedad.
- Atributos
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar la ValidationGroup propiedad para asignar un control de validación a un grupo.
Importante
Este ejemplo tiene un cuadro de texto que acepta datos proporcionados por el usuario, lo que puede suponer una amenaza para la seguridad. De forma predeterminada, ASP.NET Web Pages valida que los datos proporcionados por el usuario no incluyen elementos HTML ni de script. Para más información, consulte Información general sobre los ataques mediante scripts.
<%@ 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 runat="server">
<title>BaseValidator ValidationGroup Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>BaseValidator ValidationGroup Example</h3>
Please enter your name:<br/>
<asp:textbox id="NameTextBox"
runat="server"/>
<asp:requiredfieldvalidator id="NameTextBoxRequiredValidator"
controltovalidate="NameTextBox"
display="Dynamic"
text="Please enter your name."
validationgroup="UserInfoGroup"
runat="server"/>
<br /><br />
<asp:button id="SubmitButton"
text="Submit"
validationgroup="UserInfoGroup"
runat="server"/>
<hr/>
Please enter a search topic:<br/>
<asp:textbox id="SearchTextBox"
runat="server"/>
<asp:requiredfieldvalidator id="SearchTextBoxRequiredValidator"
controltovalidate="SearchTextBox"
display="Dynamic"
text="Please enter a topic."
validationgroup="SearchGroup"
runat="server"/>
<br /><br />
<asp:button id="SearchButton"
text="Search"
validationgroup="SearchGroup"
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>BaseValidator ValidationGroup Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>BaseValidator ValidationGroup Example</h3>
Please enter your name:<br/>
<asp:textbox id="NameTextBox"
runat="server"/>
<asp:requiredfieldvalidator id="NameTextBoxRequiredValidator"
controltovalidate="NameTextBox"
display="Dynamic"
text="Please enter your name."
validationgroup="UserInfoGroup"
runat="server"/>
<br /><br />
<asp:button id="SubmitButton"
text="Submit"
validationgroup="UserInfoGroup"
runat="server"/>
<hr/>
Please enter a search topic:<br/>
<asp:textbox id="SearchTextBox"
runat="server"/>
<asp:requiredfieldvalidator id="SearchTextBoxRequiredValidator"
controltovalidate="SearchTextBox"
display="Dynamic"
text="Please enter a topic."
validationgroup="SearchGroup"
runat="server"/>
<br /><br />
<asp:button id="SearchButton"
text="Search"
validationgroup="SearchGroup"
runat="server"/>
</form>
</body>
</html>
Comentarios
ASP.NET proporciona muchos controles que tienen la capacidad de volver a publicar en el servidor. Cuando uno de estos controles tiene su CausesValidation
propiedad establecida true
en , la validación se realiza cuando el control vuelve al servidor. Los siguientes controles tienen la capacidad de volver a publicar en el servidor:
Nota
Algunos de estos controles se devuelven al servidor solo cuando la AutoPostBack
propiedad está establecida en true
.
Cada uno de estos controles tiene una ValidationGroup
propiedad que, cuando se establece, valida solo los controles de validación dentro del grupo especificado cuando el control desencadena una publicación en el servidor. Utilice la ValidationGroup propiedad para asignar un control de validación a un grupo de validación. La Page clase también expone un GetValidators método y un Validate método que aceptan un ValidationGroup parámetro de entrada.
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.