Validar datos en conjuntos de datos en aplicaciones .NET Framework

La validación de datos es el proceso de confirmar que los valores especificados en objetos de datos cumplen las restricciones dentro del esquema de un conjunto de datos. El proceso de validación también confirma que estos valores siguen las reglas establecidas para la aplicación. Se recomienda validar los datos antes de enviar actualizaciones a la base de datos subyacente. Esto reduce el número de errores así como el posible número de recorridos de ida y vuelta entre una aplicación y la base de datos.

Puede confirmar que los datos que se escriben en un conjunto de datos son válidos mediante la creación de comprobaciones de validación en el propio conjunto de datos. El conjunto de datos puede comprobar los datos independientemente de cómo se realice la actualización, ya sea directamente por controles de un formulario, dentro de un componente o de alguna otra manera. Dado que el conjunto de datos forma parte de la aplicación (a diferencia del back-end de la base de datos), es un lugar lógico para compilar la validación específica de la aplicación.

El mejor lugar para agregar validación a la aplicación es en el archivo de clase parcial del conjunto de datos. En Visual Basic o Visual C#, abra el Diseñador de DataSet y haga doble clic en la columna o tabla para la que desea crear la validación. Esta acción abre el archivo de código, donde puede crear un controlador de eventos ColumnChanging o RowChanging.

private static void OnColumnChanging(object sender, DataColumnChangeEventArgs e)
{

}

Private Shared Sub OnColumnChanging(sender As Object, e As DataColumnChangeEventArgs)

End Sub

Validación de datos

La validación dentro de un conjunto de datos se realiza de las siguientes maneras:

• Mediante la creación de su propia validación específica de la aplicación que puede comprobar valores en una columna de datos individual durante los cambios. Para más información, consulte Procedimiento: Validación de datos durante los cambios de columna.

• Al crear su propia validación específica de la aplicación que puede comprobar los datos en valores mientras cambia toda una fila de datos. Para más información, consulte Procedimiento: Validación de datos durante los cambios de fila.

• Mediante la creación de claves, restricciones únicas, etc. como parte de la definición de esquema real del conjunto de datos.

• Al establecer las propiedades del objeto DataColumn, como MaxLength, AllowDBNull y Unique.

El objeto DataTable genera varios eventos cuando se produce un cambio en un registro:

• Los eventos ColumnChanging y ColumnChanged se generan durante y después de cada cambio en una columna individual. El evento ColumnChanging es útil cuando desea validar los cambios en columnas específicas. La información sobre el cambio propuesto se pasa como argumento con el evento.
• Los eventos RowChanging y RowChanged se generan durante y después de cualquier cambio en una fila. El evento RowChanging es más general. Indica que se está produciendo un cambio en algún lugar de la fila, pero no sabe qué columna ha cambiado.

De forma predeterminada, cada cambio en una columna genera cuatro eventos. El primero son los eventos ColumnChanging y ColumnChanged de la columna específica que se va a cambiar. A continuación se muestran los eventos RowChanging y RowChanged. Si se realizan varios cambios en la fila, los eventos se generarán para cada cambio.

El evento que elija dependerá de la granularidad que desee que sea la validación. Si es importante que detecte un error inmediatamente cuando cambia una columna, compile la validación mediante el evento ColumnChanging. De lo contrario, use el evento RowChanging, lo que podría dar lugar a la detección de varios errores a la vez. Además, si los datos están estructurados para que el valor de una columna se valide en función del contenido de otra columna, realice la validación durante el evento RowChanging.

Cuando se actualizan los registros, el objeto DataTable genera eventos a los que puede responder a medida que se producen cambios y después de realizar los cambios.

Si la aplicación usa un conjunto de datos con tipo, puede crear controladores de eventos fuertemente tipados. Esto agrega cuatro eventos con tipo adicionales para los que puede crear controladores: dataTableNameRowChanging, dataTableNameRowChanged, dataTableNameRowDeleting y dataTableNameRowDeleted. Estos controladores de eventos con tipo pasan un argumento que incluye los nombres de columna de la tabla que facilitan la escritura y lectura del código.

Eventos de actualización de datos

Los eventos ColumnChanging, RowChanging y RowDeleting se generan durante el proceso de actualización. Puede usar estos eventos para validar los datos o realizar otros tipos de procesamiento. Dado que la actualización está en proceso durante estos eventos, puede cancelarla iniciando una excepción, lo que impide que finalice la actualización.

Los eventos ColumnChanged, RowChanged y RowDeleted son eventos de notificación que se generan cuando la actualización ha finalizado correctamente. Estos eventos son útiles cuando desea realizar más acciones en función de una actualización correcta.

Validación de datos durante los cambios de columna

Puede validar los datos cuando se modifican los valores en una fila de datos respondiendo al evento ColumnChanging. Cuando se provoca, este evento pasa un argumento de evento (ProposedValue) que contiene el valor propuesto para la columna actual. En función del contenido de e.ProposedValue, puede:

• Aceptar el valor propuesto sin hacer nada.

• Rechazar el valor propuesto estableciendo el error de la columna (SetColumnError) desde el controlador de eventos que ha modificado la fila.

• Utilizar opcionalmente un control ErrorProvider para mostrar un mensaje de error al usuario. Para obtener más información, vea ErrorProvider (Componente).

La validación también se puede realizar durante el evento RowChanging.

Validación de datos durante los cambios de fila

Puede escribir código para comprobar que cada columna que desee validar contiene datos que cumplen los requisitos de la aplicación. Para ello, establezca la columna para indicar que contiene un error si un valor propuesto no es aceptable. Los ejemplos siguientes establecen un error de la columna cuando la columna Quantity es igual o menor que 0. Los controladores de eventos que modifican la fila se parecerán a los ejemplos siguientes.

Para validar los datos cuando se modifica una fila (Visual Basic)

1. Abra su conjunto de datos en el Diseñador de Dataset. Para más información, consulte Tutorial: Creación de un conjunto de datos en el Diseñador de DataSet.

2. Haga doble clic en la barra de título de la tabla que desee validar. Esta acción crea automáticamente el controlador de eventos RowChanging del control DataTable en el archivo de clase parcial del conjunto de datos.

   Sugerencia

   Haga doble clic a la izquierda del nombre de la tabla para crear el controlador de eventos que modifique la fila. Si hace doble clic en el nombre de tabla, puede editarlo.

   Private Sub Order_DetailsDataTable_Order_DetailsRowChanging(
       ByVal sender As System.Object, 
       ByVal e As Order_DetailsRowChangeEvent
     ) Handles Me.Order_DetailsRowChanging
   
       If CType(e.Row.Quantity, Short) <= 0 Then
           e.Row.SetColumnError("Quantity", "Quantity must be greater than 0")
       Else
           e.Row.SetColumnError("Quantity", "")
       End If
   End Sub
   

Para validar los datos cuando se modifica una fila (C#)

1. Abra su conjunto de datos en el Diseñador de Dataset. Para más información, consulte Tutorial: Creación de un conjunto de datos en el Diseñador de DataSet.

2. Haga doble clic en la barra de título de la tabla que desee validar. Esta acción crea un archivo de clase parcial para el control DataTable.

   Nota:

   El Diseñador de DataSet no crea automáticamente un controlador de eventos para el evento RowChanging. 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.

3. Copie el código siguiente en la clase parcial:

   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", "");
       }
   }
   

Para recuperar filas modificadas

Cada fila de una tabla de datos tiene una propiedad RowState que realiza un seguimiento del estado actual de esa fila mediante los valores de la enumeración DataRowState. Puede devolver filas modificadas de un conjunto de datos o una tabla de datos llamando al método GetChanges de DataSet o DataTable. Puede comprobar que existen cambios antes de llamar a GetChanges mediante una llamada al método HasChanges de un conjunto de datos.

Al llamar al método GetChanges de un conjunto de datos o una tabla de datos, se devuelve un nuevo conjunto de datos o tabla de datos que contiene solo los registros que se han cambiado. Si desea obtener registros específicos (por ejemplo, solo registros nuevos o solo registros modificados), puede pasar un valor de la enumeración DataRowState como parámetro al método GetChanges.

Use la enumeración DataRowVersion para acceder a las distintas versiones de una fila (por ejemplo, los valores originales que estaban en una fila antes de procesarla).

Para obtener todos los registros modificados de un conjunto de datos

• Llame al método GetChanges de un conjunto de datos.

  En el ejemplo siguiente se crea un nuevo conjunto de datos denominado changedRecords y se rellena con todos los registros modificados de otro conjunto de datos denominado dataSet1.

  • C#
  • VB

  DataSet changedRecords = dataSet1.GetChanges();
  

Para obtener todos los registros modificados de una tabla de datos

• Llame al método GetChanges de una DataTable.

  En el ejemplo siguiente se crea una nueva tabla de datos denominada changedRecordsTable y se rellena con todos los registros modificados de otra tabla de datos denominada dataTable1.

  • C#
  • VB

  DataTable changedRecordsTable = dataTable1.GetChanges();
  

Para obtener todos los registros que tienen un estado de fila específico

• Llame al método GetChanges de un conjunto de datos o tabla de datos y pase un valor de enumeración DataRowState como argumento.

  En el ejemplo siguiente se muestra cómo crear un nuevo conjunto de datos denominado addedRecords y rellenarlo solo con registros que se han agregado al conjunto de datos dataSet1.

  • C#
  • VB

  DataSet addedRecords = dataSet1.GetChanges(DataRowState.Added);
  

  En el ejemplo siguiente se muestra cómo devolver todos los registros que se agregaron recientemente a la tabla Customers:

  • C#
  • VB

  private NorthwindDataSet.CustomersDataTable GetNewRecords()
  {
      return (NorthwindDataSet.CustomersDataTable)
          northwindDataSet1.Customers.GetChanges(DataRowState.Added);
  }
  

Acceso a la versión original de un DataRow

Cuando los cambios se realizan en las filas de datos, el conjunto de datos retiene tanto la versión original (Original) como las versiones nuevas (Current) de la fila. Por ejemplo, antes de llamar al método AcceptChanges, su aplicación puede tener acceso a las distintas versiones de un registro (según se defina en la enumeración DataRowVersion) y procesar los cambios según corresponda.

Si se pasa el valor DataRowVersion junto con el índice de la columna (o el nombre de la columna como cadena), se devuelve el valor de la versión de fila concreta de esa columna. La columna modificada se identifica durante los eventos ColumnChanging y ColumnChanged. Este es un buen momento para inspeccionar las diferentes versiones de fila con fines de validación. Sin embargo, si ha suspendido las restricciones temporalmente, esos eventos no se provocarán y deberá identificar mediante programación qué columnas han cambiado. Para ello, recorra en iteración la colección Columns y compare los distintos valores de DataRowVersion.

Para obtener la versión original de un registro

• Acceda al valor de una columna que se pasa en DataRowVersion de la fila que desea devolver.

  El ejemplo siguiente muestra cómo puede utilizar un valor DataRowVersion para obtener el valor original de un campo CompanyName en un objeto DataRow:

  • C#
  • VB

  string originalCompanyName;
  originalCompanyName = northwindDataSet1.Customers[0]
      ["CompanyName", DataRowVersion.Original].ToString();
  

Acceso a la versión actual de DataRow

Para obtener la versión actual de un registro

• Acceda al valor de una columna y agregue un parámetro al índice donde se indique qué versión de una fila desea que se devuelva.

  En el ejemplo siguiente se muestra cómo puede utilizar un valor DataRowVersion para obtener el valor actual de un campo CompanyName en un objeto DataRow:

  • C#
  • VB

  string currentCompanyName;
  currentCompanyName = northwindDataSet1.Customers[0]
      ["CompanyName", DataRowVersion.Current].ToString();
  

Contenido relacionado

• Herramientas de conjunto de datos en Visual Studio
• Procedimiento para validar datos en el control DataGridView de Windows Forms
• Procedimiento para mostrar iconos de error para la validación de formularios con el componente ErrorProvider de Windows Forms