RangeValidator (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 determinar si se encuentra entre los límites inferior y superior especificados.
<asp:RangeValidator
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"
CultureInvariantValues="True|False"
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"
MaximumValue="string"
MinimumValue="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"
Type="String|Integer|Double|Date|Currency"
ValidationGroup="string"
Visible="True|False"
Width="size"
/>
Comentarios
El control RangeValidator permite comprobar si la entrada de un usuario se encuentra entre un límite inferior y un límite superior especificados. Se pueden comprobar los intervalos entre pares de números, caracteres alfabéticos y fechas. Los límites se expresan como constantes.
Utilice la propiedad ControlToValidate para especificar el control de entrada que se va a validar. Las propiedades MinimumValue y MaximumValue especifican los valores mínimo y máximo del intervalo válido, respectivamente.
La propiedad Type se utiliza para especificar el tipo de datos de los valores que se van a comparar. Los valores que se van a comparar se convierten a este tipo de datos antes de realizarse cualquier comparación.
Nota
Si el control de entrada está vacío, no se llama a ninguna función de validación y la validación se realiza correctamente.Utilice un control RequiredFieldValidator para impedir que el usuario omita un control de entrada.
Nota
El control RangeValidator produce una excepción si el valor especificado por la propiedad MaximumValue o MinimumValue no se puede convertir al tipo de datos especificado por la propiedad Type.Por ejemplo, cuando la propiedad Type de un control RangeValidator se establece en "Currency", las propiedades MinimumValue y MaximumValue se deben proporcionar en un formato como el que se describe en NumberFormatInfo.CurrencyDecimalDigits; de lo contrario, se producirá una excepción.
Para obtener más información acerca del control RangeValidator, vea la clase System.Web.UI.WebControls.RangeValidator.
Ejemplo
En el siguiente ejemplo de código se muestra cómo usar el control RangeValidator para validar si el valor especificado en un cuadro de texto se encuentra entre 1 y 10. A continuación, se muestra el resultado de validación en la página.
.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. |
<%@ Page Language="VB" AutoEventWireup="True" %>
<!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>
<title>RangeValidator Control (General Reference)</title>
<script runat="server">
Sub ButtonClick(sender As Object, e As EventArgs)
If Page.IsValid Then
Label1.Text="Page is valid."
Else
Label1.Text="Page is not valid!!"
End If
End Sub
</script>
</head>
<body>
<form id="Form1" runat="server">
<h3>RangeValidator Example</h3>
Enter a number from 1 to 10:
<br />
<asp:TextBox id="TextBox1"
runat="server"/>
<br />
<asp:RangeValidator id="Range1"
ControlToValidate="TextBox1"
MinimumValue="1"
MaximumValue="10"
Type="Integer"
EnableClientScript="false"
Text="The value must be from 1 to 10!"
runat="server"/>
<p />
<asp:Label id="Label1"
runat="server"/>
<p />
<asp:Button id="Button1"
Text="Submit"
OnClick="ButtonClick"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<!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>
<title>RangeValidator Control (General Reference)</title>
<script runat="server">
void ButtonClick(Object sender, EventArgs e)
{
if (Page.IsValid)
{
Label1.Text="Page is valid.";
}
else
{
Label1.Text="Page is not valid!!";
}
}
</script>
</head>
<body>
<form id="Form1" runat="server">
<h3>RangeValidator Example</h3>
Enter a number from 1 to 10:
<br />
<asp:TextBox id="TextBox1"
runat="server"/>
<br />
<asp:RangeValidator id="Range1"
ControlToValidate="TextBox1"
MinimumValue="1"
MaximumValue="10"
Type="Integer"
EnableClientScript="false"
Text="The value must be from 1 to 10!"
runat="server"/>
<p />
<asp:Label id="Label1"
runat="server"/>
<p />
<asp:Button id="Button1"
Text="Submit"
OnClick="ButtonClick"
runat="server"/>
</form>
</body>
</html>