Tutorial: Agregar validación a un conjunto de datos

  • Artículo

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

Es posible que tu equipo muestre nombres o ubicaciones diferentes para algunos de los elementos de la interfaz de usuario de Visual Studio en las siguientes instrucciones. La edición de Visual Studio que se tenga y la configuración que se utilice determinan estos elementos. Para obtener más información, consulte Customizing Development Settings in Visual Studio.

Las tareas ilustradas en este tutorial incluyen:

Requisitos previos

Para completar las tareas de este tutorial, necesitará:

Crear una nueva aplicación para Windows

Para crear el nuevo proyecto de aplicación para Windows

  1. En 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 Desarrollar aplicaciones cliente con .NET Framework.

    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 datos de origen y luego 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.

  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 ErrorProvider de DataSource 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 inferior, 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

Enlazar controles de Windows Forms a datos en Visual Studio

Preparar la aplicación para recibir datos

Buscar datos en la aplicación

Enlazar controles a los datos en Visual Studio

Modificar datos en la aplicación

Validar datos

Guardar datos

Otros recursos

Tutoriales sobre datos

Conectarse a datos en Visual Studio