RequiredFieldValidator (Control, referencia general)
[Esta documentación se proporciona solo para fines preliminares y está sujeta a cambios en versiones posteriores. Se incluye temas en blanco como marcadores].
Evalúa el valor de un control de entrada para asegurar que el usuario especifica un valor.
<asp:RequiredFieldValidator
AccessKey="string"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
ControlToValidate="string"
CssClass="string"
Display="None|Static|Dynamic"
EnableClientScript="True|False"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
ErrorMessage="string"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
ID="string"
InitialValue="string"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
runat="server"
SetFocusOnError="True|False"
SkinID="string"
Style="string"
TabIndex="integer"
Text="string"
ToolTip="string"
ValidationGroup="string"
Visible="True|False"
Width="size"
/>
Comentarios
El control RequiredFieldValidator se utiliza para convertir un control de entrada en un campo obligatorio. El control de entrada no supera la validación si el valor que contiene no cambia con respecto al valor inicial cuando se realizó la validación. Esto impide que el usuario deje el control de entrada asociado sin modificar. De manera predeterminada, el valor inicial es una cadena vacía (""), lo que indica que se debe especificar un valor en el control de entrada para que supere la validación.
Nota
Antes de realizar la validación se quitan los espacios adicionales situados al principio y al final del valor de entrada.De este modo, se evita que un espacio introducido en el control de entrada supere la validación.
A veces, se desea tener un valor inicial que no sea una cadena vacía. Esto resulta útil cuando hay un valor predeterminado para un control de entrada y se desea que el usuario seleccione otro valor. Por ejemplo, puede existir un control ListBox con una entrada seleccionada, de manera predeterminada, que contenga instrucciones para que el usuario seleccione un elemento de la lista. El usuario debe seleccionar un elemento del control, pero se desea que el usuario no seleccione el elemento que contiene las instrucciones. Para impedir que el usuario seleccione este elemento, especifique su valor como valor inicial. Si el usuario selecciona este elemento, el control RequiredFieldValidator muestra su mensaje de error. Para especificar el valor inicial del control de entrada asociado, establezca la propiedad InitialValue.
Nota
La propiedad InitialValue no establece el valor predeterminado del control de entrada.Ni siquiera es necesario que la propiedad InitialValue coincida con el valor predeterminado del control de entrada.Indica simplemente el valor que el usuario no podrá especificar en el control de entrada.El control de entrada no superará la validación si contiene este valor al realizarse la validación.
Se pueden asociar varios validadores al mismo control de entrada. Por ejemplo, se puede utilizar un control RequiredFieldValidator para asegurarse de que se han escrito datos en un control y, al mismo tiempo, utilizar un control RangeValidator para garantizar que la entrada esté comprendida dentro del intervalo de datos especificado.
Para obtener más información acerca del control RequiredFieldValidator, vea la clase RequiredFieldValidator.
Ejemplo
En el ejemplo de código siguiente se muestra cómo utilizar el control RequiredFieldValidator para convertir un control TextBox en un campo obligatorio.
.gif "Nota de seguridad") Nota sobre la seguridad |
|---|
En este ejemplo hay un cuadro de texto que acepta datos del usuario, lo que puede suponer una amenaza para la seguridad.De forma predeterminada, las ASP.NET Web Pages validan los datos escritos por el usuario para comprobar que no incluyen script ni elementos HTML.Para obtener más información, vea Script Exploits Overview. |
Name:
<asp:TextBox id="Text1"
Text="Enter a value"
runat="server"/>
<asp:RequiredFieldValidator id="RequiredFieldValidator1"
ControlToValidate="Text1"
Text="Required Field!"
runat="server"/>
<p />
<asp:Button id="Button1"
runat="server"
Text="Validate"/>
Name:
<asp:TextBox id="Text1"
Text="Enter a value"
runat="server"/>
<asp:RequiredFieldValidator id="RequiredFieldValidator1"
ControlToValidate="Text1"
Text="Required Field!"
runat="server"/>
<p />
<asp:Button id="Button1"
runat="server"
Text="Validate"/>