Compartir a través de


Tutorial: Agregar validación a un conjunto de datos

Actualización: noviembre 2007

En este tutorial se muestra cómo validar los datos cuando se realizan cambios en un conjunto de datos. El momento en que realice las comprobaciones de validación de los datos depende de los requisitos de su aplicación; para este tutorial, validaremos los datos durante la realización de cambios en los valores de columnas concretas. Este tutorial utiliza el evento ColumnChanging para comprobar que se especifica un valor aceptable en el registro. Si el valor no es válido, se muestra al usuario un control ErrorProvider.

En el ejemplo también se muestra cómo utilizar el Diseñador de DataSet para crear una clase parcial para el conjunto de datos. (La clase parcial es donde los usuarios pueden agregar código para ampliar la funcionalidad del conjunto de datos generado por Visual Studio. No se sobrescribe si se vuelve a generar el conjunto de datos.)

Nota:

Los cuadros de diálogo y comandos de menú que se ven podrían ser distintos de los que se describen en la Ayuda, dependiendo de la configuración o edición activas. Para cambiar la configuración, elija Importar y exportar configuraciones en el menú Herramientas. Para obtener más información, vea Valores de configuración de Visual Studio.

En este tutorial se muestran las siguientes tareas:

Requisitos previos

Para poder completar este tutorial, necesitará:

Crear una nueva aplicación para Windows

Para crear el nuevo proyecto de aplicación para Windows

  1. Desde el menú Archivo, cree un nuevo proyecto.

  2. Asigne al proyecto el nombre ValidationWalkthrough.

  3. Seleccione Aplicación para Windows y haga clic en Aceptar. Para obtener más información, vea Crear aplicaciones basadas en Windows.

    El proyecto ValidationWalkthrough se crea y se agrega al Explorador de soluciones.

Crear un nuevo origen de datos a partir de su base de datos

Para crear el origen de datos

  1. En el menú Datos, haga clic en Mostrar orígenes de datos.

  2. En la ventana Orígenes de datos, seleccione Agregar nuevo origen de datos para iniciar el Asistente para configuración de orígenes de datos.

  3. Seleccione Base de datos en la página Elegir un tipo de origen de datos y, a continuación, haga clic en Siguiente.

  4. En la página Elegir la conexión de datos realice una de las siguientes operaciones:

    • Si una conexión de datos a la base de datos de ejemplo Northwind está disponible en la lista desplegable, selecciónela.

      O bien

    • Seleccione Nueva conexión para iniciar el cuadro de diálogo Agregar o modificar conexión. Para obtener más información, vea Agregar/Modificar conexión (Cuadro de diálogo, General).

  5. Si su base de datos requiere una contraseña, seleccione la opción para incluir datos confidenciales y haga clic en Siguiente.

  6. Haga clic en Siguiente en la página Guardar la cadena de conexión en el archivo de configuración de la aplicación.

  7. Expanda el nodo Tables en la página Elija los objetos de base de datos.

  8. Seleccione la tabla Order Details y, a continuación, haga clic en Finalizar.

    Se agrega a su proyecto NorthwindDataSet y la tabla OrderDetails aparece en la ventana Orígenes de datos.

Crear controles enlazados a datos

Para crear controles enlazados en el formulario

  1. En la ventana Orígenes de datos, seleccione la tabla Order Details.

  2. Elija Detalles en la lista de controles de la tabla.

  3. Arrastre el nodo Detalles de pedido desde la ventana Orígenes de datos hasta Form1.

    Los controles enlazados a datos con etiquetas descriptivas aparecen en el formulario, junto con una barra de herramientas (BindingNavigator) para navegar por los registros. Los controles enlazados a datos con etiquetas descriptivas aparecen en el formulario, junto con una barra de herramientas (BindingNavigator) para navegar por los registros. NorthwindDataSet, Order_DetailsTableAdapter, BindingSourcey BindingNavigator aparecerán en la bandeja de componentes.

Agregar un control ErrorProvider al formulario

Para configurar un control ErrorProvider

  1. Arrastre un ErrorProvider desde el Cuadro de herramientas hasta Form1.

  2. En la ventana Propiedades, establezca la propiedad DataSource de ErrorProvider en el origen Order_DetailsBindingSource.

    Nota:

    No establezca la propiedad DataMember.

Crear el controlador de eventos ColumnChanging

Para crear los controladores de eventos de la validación

  1. Abra el conjunto de datos NorthwindDataSet en el Diseñador de DataSet haciendo doble clic en el archivo NorthwindDataSet.xsd en el Explorador de soluciones.

  2. Haga doble clic en la columna Quantity de la tabla OrderDetails para crear el controlador de eventos OrderDetailsDataTable_ColumnChanging. (Sólo en C# se creará la clase parcial de la tabla de datos.)

    Nota:

    Al hacer doble clic en el nombre de la tabla (Order Details en la barra de título) se crea un controlador de eventos para el evento RowChanging.

  3. Agregue código para comprobar que e.ProposedValue contiene valores mayores que 0. Si el valor propuesto es 0 o menor, establezca la columna para indicar que contiene un error.

    Pegue el código siguiente en el controlador de eventos de cambio de columna debajo del comentario Agregar código de usuario aquí:

    If CType(e.ProposedValue, Short) <= 0 Then
            e.Row.SetColumnError(e.Column, "Quantity must be greater than 0")
        Else
            e.Row.SetColumnError(e.Column, "")
    End If
    
    // C#
    // Add the following code 
    // to the partial class.
        public override void EndInit()
        {
            base.EndInit();
            Order_DetailsRowChanging += TestRowChangeEvent;
        }
    
        public void TestRowChangeEvent(object sender, Order_DetailsRowChangeEvent e)
        {
            if ((short)e.Row.Quantity <= 0)
            {
                e.Row.SetColumnError("Quantity", "Quantity must be greater than 0");
            }
            else
            {
                e.Row.SetColumnError("Quantity", "");
            }
        }
    

Probar la aplicación

Para probar la aplicación

  1. Presione F5 para ejecutar la aplicación.

  2. Cambie el valor en el cuadro de texto Cantidad a 0.

  3. Presione TAB para sacar el foco del cuadro de texto.

    Aparecerá el icono de proveedor de error.

  4. Coloque el puntero del mouse sobre el proveedor del error para ver el mensaje.

Pasos siguientes

Dependiendo de los requisitos de la aplicación, puede ser conveniente realizar varios pasos después de agregar la validación. Entre las mejoras que podría realizar se incluyen:

Vea también

Conceptos

Lo nuevo en datos

Información general sobre la presentación de datos

Otros recursos

Tutoriales sobre datos

Conectarse a datos en Visual Studio

Preparar la aplicación para recibir datos

Buscar datos en la aplicación

Mostrar datos en formularios en aplicaciones para Windows

Modificar datos en la aplicación

Validar datos

Guardar datos