Agregar validación

En esta lección se muestra cómo validar los datos que un usuario escribe en una aplicación LightSwitch.

Agregar validación de datos

En casi cualquier aplicación que implica entrada de datos, los datos se deben validar antes de guardar.Por ejemplo, puede que desee comprobar que un número de teléfono contiene el número correcto de dígitos o que un campo obligatorio no está vacío.

El diseñador de datos contiene un ejemplo de un tipo de validación: cada campo de la entidad tiene una casilla denominada Necesario.Si un campo se marca como necesario y el campo está vacío, LightSwitch muestra automáticamente una advertencia cuando el usuario intenta guardar los datos.

También puede administrar la validación en LightSwitch estableciendo las propiedades de validación o escribiendo el código de validación personalizado.

Cómo establecer propiedades de validación

En el Explorador de soluciones, haga doble clic en Contactos.
En el Diseñador de datos, haga clic en <Agregar propiedad> y, a continuación, escriba EstadoDeContacto.
Asegúrese de que el tipo es String.
En la ventana Propiedades, seleccione la propiedad Longitud máxima y escriba 2.

Este valor asegura que no se pueden escribir más de dos caracteres en el campo EstadoDeContacto.

Cómo agregar código de validación personalizada

En el Explorador de soluciones, haga doble clic en Detalles_Orden.
En el Diseñador de datos, seleccione el campo Cantidad.
En la pantalla Propiedades, haga clic en el vínculo Validación personalizada.

El Editor de código se abre y se muestra un bloque de código para el método Quantity_Validate.
Agregue el código siguiente al método Quantity_Validate justo debajo de la línea de comentario.

Precaución

Agregue código Visual Basic o C#, dependiendo del lenguaje de programación elegido al crear el proyecto.
```
If Quantity < 1 Then
    results.AddPropertyError("Quantity must be greater than zero.")
End If
```
```
if (Quantity < 1) 
{
    results.AddPropertyError("Quantity must be greater than zero.");
}
```
Este código asegura que un valor menor que uno en el campo Cantidad no se puede guardar.Si un usuario intenta guardar un valor menor que uno, se activa un error de validación.

Precaución
Agregue código Visual Basic o C#, dependiendo del lenguaje de programación elegido al crear el proyecto.

Información detallada

En esta lección mostró cómo validar datos estableciendo las propiedades de validación o escribiendo el código de la validación.Propiedades de validación diferentes están disponibles para tipos de datos diferentes.Por ejemplo, un tipo String tiene una propiedad Longitud máxima y un Integer tiene las propiedades Valor máximo y Valor mínimo.Todos los tipos tienen una propiedad de Es obligatorio, que es la propiedad que se utiliza para la casilla de verificación Necesario en el Diseñador de datos.

Si examina la entidad Customers, observe que las propiedades de validación aparecen atenuadas y no se pueden cambiar.Algunos campos como Dirección ya tienen un valor en la propiedad Longitud máxima.No se pueden establecer las propiedades de validación en una entidad de un origen de datos adjunto; únicamente se pueden establecer en las entidades que haya creado.

Si desea agregar la validación para una entidad de un origen de datos adjunto, puede hacerlo escribiendo su propio código de validación.No puede invalidar las propiedades de validación existentes a menos que esté agregando una validación más restrictiva.Por ejemplo, en un campo que tiene una Longitud máxima de 30, no se puede agregar código de validación para establecer la longitud en 40.Sin embargo, se podría agregar código para restringir la longitud a menos de 30.