Data Annotations

En el artículo anterior, comenzamos a profundizar en el tema muy relevante de Model Binding. Con Model Binding, podemos crear una conexión más fuerte entre el Modelo y la Vista y, a cambio, obtenemos mucha ayuda en la creación de marcado y procesamiento de solicitudes. La Vista simplemente "lee" tu Modelo (clase) y, a continuación, utiliza la información disponible para ayudarte, por ejemplo, mediante la creación de un control de cuadro de texto relevante para una propiedad en un formulario.

Sin embargo, a veces puede ser relevante para tus vistas conocer mucho más sobre una propiedad en tu modelo que simplemente su nombre y su tipo. Para estas situaciones, ASP.NET MVC viene con el concepto de DataAnnotations (algunas veces referido como Atributos de modelo o Model Attributes), los cuales básicamente permiten agregar metadatos a una propiedad. Una cosa genial sobre DataAnnotations es que ellos no alteran el uso de tus modelos afuera del framework MVC.

Cómo usar DataAnnotations

Permíteme darte una idea rápida de cómo las DataAnnotations trabajan. Por ejemplo, un escenario muy común, el cual vimos de hecho en un artículo previo, es que queremos que el framework genere una etiqueta y un campo de entrada para una propiedad. Cuando genera la etiqueta con el nombre de la propiedad es utilizado como pero los nombres propiedades generalmente no son buenos a la vista de los humanos. Un ejemplo de eso, nosotros podemos querer cambiar la forma en la que se muestra la propiedad FirstName a First Name". Con DataAnnotations, eso es muy fácil:

public class WebUser
{
    [Display(Name="First Name")]
    public string FirstName { get; set; }
}

Nótese cómo la DataAnnotation se sitúa por encima de la propiedad, justo como cualquier otro tipo de atributo personalizado en C#. Usando la DataAnnotiation Display, podemos alterar como se muestra la versión de la propiedad name. Con eso en su lugar, nuestra propiedad conserva su nombre original, pero siempre es presentado al usuario, con la versión alternativa usada de "First Name".

Tipos de DataAnnotations

Esto sólo es un ejemplo de los muchos atributos disponibles de DataAnnotation. Hay muchos más, pero también muchos de ellos se relacionan directamente a la validación, un tema el cual estaremos discutiendo en uno de nuestros siguientes artículos. Pero para una lista completa de atributos de notación, sugiero que cheques la documentación.

Resumen

DataAnnotations te permiten enriquecer tus modelos con metadatos, los cuales pueden ser usados para un amplio Rango de propósitos por el framework MVC. Daremos sobre uno de los más importantes casos de uso para DataAnnotations en el siguiente artículo: Validación del modelo.