Compartir a través de

Plantillas de generación de código del diseñador

Cuando se crea un modelo mediante entity Framework Designer, las clases y el contexto derivado se generan automáticamente. Además de la generación de código predeterminada, también proporcionamos una serie de plantillas que se pueden usar para personalizar el código que se genera. Estas plantillas se proporcionan como plantillas de texto T4, lo que le permite personalizar las plantillas si es necesario.

El código que se genera de forma predeterminada depende de la versión de Visual Studio en la que cree el modelo:

  • Los modelos creados en Visual Studio 2012 y 2013 generarán clases de entidad POCO simples y un contexto que deriva de DbContext simplificado.
  • Los modelos creados en Visual Studio 2010 generarán clases de entidad que derivan de EntityObject y un contexto que deriva de ObjectContext.

Nota:

Se recomienda cambiar a la plantilla Generador de DbContext una vez que haya agregado el modelo.

En esta página se describen las plantillas disponibles y, a continuación, se proporcionan instrucciones para agregar una plantilla al modelo.

Plantillas disponibles

El equipo de Entity Framework proporciona las siguientes plantillas:

Generador de DbContext

Esta plantilla generará clases de entidad POCO simples y un contexto que deriva de DbContext mediante EF6. Esta es la plantilla recomendada a menos que tenga una razón para usar una de las otras plantillas que se enumeran a continuación. También es la plantilla de generación de código que obtiene de forma predeterminada si usa versiones recientes de Visual Studio (Visual Studio 2013 en adelante): al crear un nuevo modelo, esta plantilla se usa de forma predeterminada y los archivos T4 (.tt) están anidados en el archivo .edmx.

Versiones anteriores de Visual Studio

  • Visual Studio 2012: Para obtener las plantillas dbContextGenerator de EF 6.x , deberá instalar las herramientas de Entity Framework más recientes para Visual Studio ; consulte la página Obtener Entity Framework para obtener más información.
  • Visual Studio 2010: Las plantillas dbContextGenerator de EF 6.x no están disponibles para Visual Studio 2010.

Generador dbContext para EF 5.x

Si usa una versión anterior del paquete NuGet EntityFramework (uno con una versión principal de 5), deberá usar la plantilla Generador dbContext de EF 5.x .

Si usa Visual Studio 2013 o 2012, esta plantilla ya está instalada.

Si usa Visual Studio 2010, deberá seleccionar la pestaña En línea al agregar la plantilla para descargarla desde la Galería de Visual Studio. Como alternativa, puede instalar la plantilla directamente desde la Galería de Visual Studio con antelación. Dado que las plantillas se incluyen en versiones posteriores de Visual Studio, las versiones de la galería solo se pueden instalar en Visual Studio 2010.

Generador de DbContext para EF 4.x

Si usa una versión anterior del paquete NuGet EntityFramework (uno con una versión principal de 4), deberá usar la plantilla Generador dbContext de EF 4.x . Esto se puede encontrar en la pestaña En línea al agregar la plantilla, o puede instalar la plantilla directamente desde la Galería de Visual Studio con antelación.

Generador de EntityObject

Esta plantilla generará clases de entidad que derivan de EntityObject y un contexto que deriva de ObjectContext.

Nota:

Considere la posibilidad de usar el generador de DbContext

DbContext Generator es ahora la plantilla recomendada para las nuevas aplicaciones. DbContext Generator aprovecha la API DbContext más sencilla. EntityObject Generator sigue estando disponible para admitir aplicaciones existentes.

Visual Studio 2010, 2012 y 2013

Deberá seleccionar la pestaña En línea al agregar la plantilla para descargarla desde la Galería de Visual Studio. Como alternativa, puede instalar la plantilla directamente desde la Galería de Visual Studio con antelación.

Generador de EntityObject para EF 5.x

Si usa Visual Studio 2012 o 2013, deberá seleccionar la pestaña En línea al agregar la plantilla para descargarla desde la Galería de Visual Studio. Como alternativa, puede instalar la plantilla directamente desde la Galería de Visual Studio con antelación. Dado que las plantillas se incluyen en Visual Studio 2010, las versiones de la galería solo se pueden instalar en Visual Studio 2012 y 2013.

Si solo desea la generación de código ObjectContext sin necesidad de editar la plantilla, puede revertir a la generación de código EntityObject.

Si usa Visual Studio 2010, esta plantilla ya está instalada. Si crea un nuevo modelo en Visual Studio 2010, esta plantilla se usa de forma predeterminada, pero los archivos .tt no se incluyen en el proyecto. Si desea personalizar la plantilla, deberá agregarla al proyecto.

Generador de Entidades de Auto-Seguimiento (STE)

Esta plantilla generará clases de entidad de auto-seguimiento y un contexto que deriva de ObjectContext. En una aplicación EF, un contexto es responsable del seguimiento de los cambios en las entidades. Sin embargo, en escenarios de N niveles, es posible que el contexto no esté disponible en el nivel que modifica las entidades. Las entidades de seguimiento automático le ayudan a realizar un seguimiento de los cambios en cualquier nivel. Para obtener más información, consulte Entidades de Seguimiento Automático.

Nota:

La plantilla STE no es recomendable

Ya no se recomienda usar la plantilla STE en nuevas aplicaciones, pero sigue estando disponible para dar soporte a las aplicaciones existentes. Visite el artículo Entidades desconectadas para ver otras opciones que se recomiendan para escenarios de N niveles.

Nota:

No hay ninguna versión de EF 6.x de la plantilla STE.

Nota:

No hay ninguna versión de Visual Studio 2013 de la plantilla STE.

Visual Studio 2012

Si usa Visual Studio 2012, deberá seleccionar la pestaña En línea al agregar la plantilla para descargarla desde la Galería de Visual Studio. Como alternativa, puede instalar la plantilla directamente desde la Galería de Visual Studio con antelación. Dado que las plantillas se incluyen en Visual Studio 2010, las versiones de la galería solo se pueden instalar en Visual Studio 2012.

Visual Studio 2010**

Si usa Visual Studio 2010, esta plantilla ya está instalada.

Generador de entidades POCO

Esta plantilla generará clases de entidad POCO y un contexto que deriva de ObjectContext

Nota:

Considere la posibilidad de usar el generador de DbContext

DbContext Generator es ahora la plantilla recomendada para generar clases POCO en nuevas aplicaciones. DbContext Generator aprovecha la nueva API dbContext y puede generar clases POCO más sencillas. El Generador de Entidades POCO continúa estando disponible para admitir aplicaciones existentes.

Nota:

No hay ninguna versión de EF 5.x o EF 6.x de la plantilla STE.

Nota:

No hay ninguna versión de Visual Studio 2013 de la plantilla POCO.

Visual Studio 2012 y Visual Studio 2010

Deberá seleccionar la pestaña En línea al agregar la plantilla para descargarla desde la Galería de Visual Studio. Como alternativa, puede instalar la plantilla directamente desde la Galería de Visual Studio con antelación.

¿Cuáles son las plantillas de "Sitios web"

Las plantillas "Sitios web" (por ejemplo, generador dbContext de EF 5.x para sitios web de C#) se usan en proyectos de sitio web creados a través de archivo -> Nuevo -> Sitio web.... Son diferentes de las aplicaciones web, creadas a través de Archivo - Nuevo ->> Proyecto..., que usan las plantillas estándar. Se proporcionan plantillas independientes porque el sistema de plantillas de elementos de Visual Studio los requiere.

Uso de una plantilla

Para empezar a usar una plantilla de generación de código, haga clic con el botón derecho en un lugar vacío en la superficie de diseño en EF Designer y seleccione Agregar elemento de generación de código....

Agregar elemento de generación de código

Si ya ha instalado la plantilla que quiere usar (o se incluyó en Visual Studio), estará disponible en la sección Código o Datos del menú izquierdo.

Plantilla instalada

Si aún no tiene instalada la plantilla, seleccione En línea en el menú de la izquierda y busque la plantilla que desee.

Plantilla de búsqueda  

Si usa Visual Studio 2012, los nuevos archivos .tt se anidarán en el archivo .edmx.*

Nota:

En el caso de los modelos creados en Visual Studio 2012, deberá eliminar las plantillas usadas para la generación de código predeterminada; de lo contrario, tendrá clases duplicadas y contexto generados. Los archivos predeterminados son <nombre> del modelo.tt y <nombre> del modelo.context.tt. 

Plantillas de Visual Studio 2012

Si usa Visual Studio 2010, los archivos tt se agregan directamente al proyecto.  

Plantillas de VS2010

  • Last updated on