TOC

This article has been localized into Spanish by the community.

Modelos:

Data Annotations

En los artículos previos, empezamos a indagar los temas muy relevantes del Model Binding. Con Model Binding, podemos crear una conexión más fuerte entre el modelo y la vista y en retorno, obtenemos mucha ayuda en la creación del mercado y el procesamiento de las peticiones. La vista simplemente "lee" tu modelo y luego usa la información disponible para ayudarte, creando un control de caja de texto relevante para una propiedad en el formulario.

Sin embargo, a veces puede ser relevante para turistas conocer mucho más sobre una propiedad en tu modelo que sólo 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 se permiten agregar metadatos a una propiedad. La 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; }
}

No sé cómo la DataAnnotation conoce para encima de la propiedad, justo como cualquier otro tipo de atributo personalizado en C#. Usando la DataAnnotiation Display, podemos alterar la versión de muestra de la propiedad name. Con eso en su lugar, nuestra propiedad conserva su nombre original, pero siempre que es presentado al usuario con más una versión alterna de "First Name" es usada.

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.

This article has been fully translated into the following languages: Is your preferred language not on the list? Click here to help us translate this article into your language!