Cómo: Agregar validación a un conjunto de datos con n niveles

Artículo
08/10/2011

Agregar validación a un conjunto de datos separado en una solución de n niveles es básicamente igual que agregar validación a un conjunto de datos de un solo archivo (un conjunto de datos en un único proyecto). La ubicación sugerida para realizar la validación en datos está durante ColumnChanging y/o los eventos RowChanging de una tabla de datos.

Diseñador de DataSet proporciona la funcionalidad para crear clases parciales a las que puede agregar el código de usuario a los eventos que modifican la columna y la fila de las tablas de datos en el conjunto de datos. Para obtener más información sobre cómo agregar código a un conjunto de datos en una solución de n niveles, vea Cómo: Agregar código a conjuntos de datos en aplicaciones con n niveles y Cómo: Agregar código a TableAdapters en aplicaciones con n niveles. Para obtener más información acerca de las clases parciales, consulte Cómo: Dividir una clase en clases parciales (Diseñador de clases) o Clases y métodos parciales (Guía de programación de C#).

Nota

Cuando los conjuntos de datos se separan de los TableAdapters (estableciendo la propiedad DataSet Project), las clases de conjunto de datos parciales existentes no se trasladarán automáticamente. Las clases de conjunto de datos parciales existentes se deberán trasladar manualmente al proyecto de conjunto de datos.

Nota

El Diseñador de Dataset no crea automáticamente un controlador de eventos en C# para los eventos ColumnChanging y RowChanging. Debe crear manualmente un controlador de eventos y enlazarlo hasta el evento subyacente. Los procedimientos siguientes proporcionan los pasos para crear los controladores de eventos necesarios en Visual Basic y C#.

Validar cambios para columnas individuales

Valide los valores en columnas individual administrando el evento ColumnChanging. El evento ColumnChanging se produce cuando se modifica el valor de una columna. Cree un controlador de eventos para el evento ColumnChanging haciendo doble clic en la columna que desee en el Diseñador de DataSet.

La primera vez que se hace doble clic en una columna, el diseñador genera un controlador de eventos para el evento ColumnChanging. Además del evento ColumnChanging, también se crea una instrucción If…Then que realiza pruebas para la columna concreta. Por ejemplo, se genera el código siguiente cuando se hace doble clic en la columna RequiredDate de la tabla Orders de Northwind:

Private Sub OrdersDataTable_ColumnChanging(ByVal sender As System.Object, ByVal e As System.Data.DataColumnChangeEventArgs) Handles Me.ColumnChanging
    If (e.Column.ColumnName = Me.RequiredDateColumn.ColumnName) Then
        ' Add validation code here.
    End If
End Sub

Nota

En proyectos C#, el Diseñador de DataSet crea únicamente las clases parciales para el conjunto de datos y las tablas individuales en el conjunto de datos. El Diseñador de DataSet no crea automáticamente los controladores de eventos para los eventos ColumnChanging y RowChanging en C#, como lo hace en Visual Basic. En proyectos C#, tiene que construir manualmente un método para administrar el evento y enlazar el método hasta el evento subyacente. El procedimiento siguiente proporciona los pasos para crear los controladores de eventos necesarios tanto en Visual Basic como en C#.

Nota

Es posible que su equipo muestre nombres o ubicaciones diferentes para algunos de los elementos de la interfaz de usuario de Visual Studio incluidos en las instrucciones siguientes. 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, vea Valores de configuración de Visual Studio.

Para agregar la validación durante los cambios a los valores de columna individuales

Abra el conjunto de datos en el Diseñador de DataSet haciendo doble clic en el archivo .xsd en el Explorador de soluciones. Para obtener más información, vea Cómo: Abrir un objeto Dataset en el Diseñador de Dataset.
Haga doble clic en la columna que desee validar. Esta acción crea el controlador de eventos ColumnChanging.

Nota

El Diseñador de DataSet no crea ningún controlador de eventos automáticamente para el evento de C#. El código necesario para controlar el evento en C# se incluye a continuación. Se crea SampleColumnChangingEvent y, a continuación, se enlaza al evento ColumnChanging en el método EndInit.

Agregue el código para comprobar que e.ProposedValue contiene datos que son compatibles con los requisitos de la aplicación. Si el valor propuesto no es aceptable, establezca la columna para indicar que contiene un error.

En el siguiente ejemplo de código se valida que la columna Quantity contiene más de 0. Si la Quantity es menor o igual que 0, la columna se establece en un error. La cláusula Else borra el error si la cantidad es mayor que 0. El código del controlador de eventos de la columna que cambia debe presentar un aspecto similar al siguiente:

If (e.Column.ColumnName = Me.QuantityColumn.ColumnName) Then
    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
End If

// C#
// Add this code to the DataTable 
// partial class.

    public override void EndInit()
    {
        base.EndInit();
        // Hook up the ColumnChanging event
        // to call the SampleColumnChangingEvent method.
        ColumnChanging += SampleColumnChangingEvent;
    }

    public void SampleColumnChangingEvent(object sender, System.Data.DataColumnChangeEventArgs e)
    {
        if (e.Column.ColumnName == QuantityColumn.ColumnName)
        {
            if ((short)e.ProposedValue <= 0)
            {
                e.Row.SetColumnError("Quantity", "Quantity must be greater than 0");
            }
            else
            {
                e.Row.SetColumnError("Quantity", "");
            }
        }
    }

Validar cambios para filas completas

Valide los valores en filas completas administrando el evento RowChanging. Se produce el evento RowChanging cuando se confirman los valores en todas las columnas. Esto es necesario para validar en el evento RowChanging cuando el valor en una columna depende del valor en otra columna. Por ejemplo, tenga en cuenta OrderDate y RequiredDate en la tabla Orders en Northwind. Cuando se incluyen los pedidos, la validación garantiza que un pedido no se escribe en la fecha requerida (RequiredDate) ni antes de la fecha de pedido (OrderDate). En este ejemplo, los valores para ambas columnas RequiredDate y OrderDate necesitan compararse, por ello no tiene sentido validar un cambio en una columna individual.

Cree un controlador de eventos para el evento RowChanging haciendo doble clic en el nombre de la tabla en la barra de título de la tabla del Diseñador de DataSet.

Para agregar la validación durante los cambios en las filas completas

Abra el conjunto de datos en el Diseñador de DataSet haciendo doble clic en el archivo .xsd en el Explorador de soluciones. Para obtener más información, vea Cómo: Abrir un objeto Dataset en el Diseñador de Dataset.
Haga doble clic en la barra de título de la tabla de datos en el diseñador.

Se crea una clase parcial con un controlador de eventos RowChanging y se abre en el Editor de código.

Nota

El Diseñador de DataSet no crea automáticamente un controlador para el evento RowChanging en proyectos escritos en C#. Debe crear un método para controlar el evento RowChanging y ejecutar el código para enlazar el evento en el método de inicialización de la tabla.
Agregue el código de usuario dentro de la declaración de clase parcial.

El código siguiente muestra dónde agregar el código de usuario para validar durante el evento RowChanging para Visual Basic:

Partial Class OrdersDataTable
    Private Sub OrdersDataTable_OrdersRowChanging(ByVal sender As System.Object, ByVal e As OrdersRowChangeEvent) Handles Me.OrdersRowChanging
        ' Add logic to validate columns here.
        If e.Row.RequiredDate <= e.Row.OrderDate Then
            ' Set the RowError if validation fails.
            e.Row.RowError = "Required Date cannot be on or before the OrderDate"
        Else
            ' Clear the RowError when validation passes.
            e.Row.RowError = ""
        End If
    End Sub
End Class

El código siguiente muestra cómo crear el controlador de eventos RowChanging y dónde agregar el código de usuario para validar durante el evento RowChanging para C#:

partial class OrdersDataTable
{
    public override void EndInit()
    {
        base.EndInit();
        // Hook up the event to the
        // RowChangingEvent method.
        OrdersRowChanging += RowChangingEvent;
    }

    public void RowChangingEvent(object sender, OrdersRowChangeEvent e)
    {
        // Perfom the validation logic.
        if (e.Row.RequiredDate <= e.Row.OrderDate)
        {
            // Set the row to an error when validation fails.
            e.Row.RowError = "Required Date cannot be on or before the OrderDate";
        }
        else
        {
            // Clear the RowError if validation passes.
            e.Row.RowError = "";
        }
    }
}