Introducción al control CustomValidator

  • Artículo

Actualización: noviembre 2007

Si los controles de validación proporcionados en el conjunto de controles de ASP.NET Mobile no se adaptan a sus necesidades, utilice el control CustomValidator para crear un control que realice una validación personalizada.

Control de validación personalizado de ASP.NET

Al igual que otros controles de validación, el control CustomValidator valida los datos proporcionados desde el control TextBox o SelectionList. Establezca la propiedad ControlToValidate del control CustomValidator en el identificador del control que se va a validar. Cuando un formulario que contiene un control CustomValidator se envía al servidor, el control CustomValidator provoca el evento ServerValidate. Debe proporcionar un controlador con la siguiente firma:

Private Sub EventHandlerName(
    ByVal source As System.Object, 
    ByVal args As System.Web.UI.WebControls.ServerValidateEventArgs)
    Handles CustomValidator1.ServerValidate

private void EventHandlerName(
    object source, 
    System.Web.UI.WebControls.ServerValidateEventArgs args) { }

En estos ejemplos, EventHandlerName es el nombre del método que controla el evento ServerValidate. El parámetro source es una referencia al control CustomValidator que llama a este controlador de eventos. El parámetro args contiene la información proporcionada por el usuario que se va a validar. El controlador de eventos recibe la información proporcionada por el usuario en la propiedad args.Value. Si esta información es válida, el código establece args.IsValid en true. Si el controlador del evento ServerValidate establece args.IsValid en false, el control CustomValidator muestra el texto de la propiedad ErrorMessage.

En la versión de Visual Basic de la firma de la función, el nombre CustomValidator1 hace referencia al identificador del control CustomValidator.

Cuando se agrega un control CustomValidator a un control contenedor o una plantilla:

  • La propiedad ErrorMessage se establece en "CustomValidator".

  • La propiedad StyleReference se establece en "error", que es el nombre de un estilo predefinido del objeto StyleSheet predeterminado.

Vea también

Tareas

Cómo: Agregar y configurar un control CustomValidator

Cómo: Agregar y configurar un control ValidationSummary

Conceptos

Introducción a los controles de validación

Referencia

CustomValidator