Cómo crear un nuevo Entity Data Model

En este tema se describe cómo crear un nuevo Entity Data Model (EDM) utilizando el Asistente para Entity Data Model. Los procedimientos de este tema describen cómo generar un modelo que se base en una base de datos existente (esto se recomienda para esta versión de ADO.NET Entity Data Model Designer) y cómo generar un modelo vacío.

Nota
Normalmente se genera un modelo vacío cuando se desea modelar los datos de una aplicación antes de diseñar el esquema de almacenamiento. Al modelar los datos primero, se requiere implementar la aplicación con un origen de datos que se ajuste el modelo.

Un EDM puede incluirse en las categorías de proyecto de Visual Studio siguientes:

• Proyectos de aplicación

• Bibliotecas de clases

• Proyectos web

Se pueden agregar varios EDM al mismo proyecto y cada uno puede estar destinado a una base de datos diferente, a tablas diferentes de la misma base de datos o a ambos.

Para crear un EDM a partir de una base de datos existente

1. Abra o cree el proyecto para el que desea crear un EDM.

2. En el Explorador de soluciones, haga clic con el botón secundario en el nombre del proyecto, seleccione Agregar y, a continuación, haga clic en Nuevo elemento.

3. Seleccione ADO.NET Entity Data Model en el panel Plantillas.

4. Escriba el nombre para el modelo (<nombre de proyecto.edmx)> y, a continuación, haga clic en Agregar.

   Aparece la primera página del Asistente para Entity Data Model.

5. En el cuadro de diálogo Elegir contenido de Model, seleccione Generar desde la base de datos y, a continuación, haga clic en Siguiente.

6. Haga clic en el botón Nueva conexión.

   Aparece el cuadro de diálogo Propiedades de conexión.

7. Escriba el nombre del servidor, seleccione el método de autenticación y escriba el nombre de la base de datos para la que se crea el modelo. Haga clic en Aceptar.

   El cuadro de diálogo Elegir la conexión de datos se actualiza con la configuración de la conexión de la base de datos.

   Nota

   De forma predeterminada, la configuración de la conexión de entidad se guarda en el archivo App.config o Web.config (según el tipo de proyecto). Escriba un nombre para la conexión o utilice el nombre predeterminado proporcionado. Desactive la casilla Guardar configuración de conexión de entidad si no desea que la información de conexión se guarde en un archivo de configuración. Para obtener más información acerca de cómo guardar la configuración de la conexión, vea Cuadro de diálogo Elegir la conexión de datos.

8. Para continuar, haga clic en Siguiente.

   Aparece el cuadro de diálogo Elija los objetos de base de datos. De forma predeterminada, no se selecciona ningún objeto de la base de datos para incluirse en el EDM.

9. Expanda los nodos correspondientes a Tablas, Vistas y Procedimientos almacenados. Cancele la selección de cualquier tabla, vista y procedimiento almacenado que no desee que se incluya en el modelo.

   Nota
   Las clases generadas a partir del modelo conceptual estarán en el Espacio de nombres de Model. Escriba un nombre para el espacio de nombres o utilice el nombre predeterminado proporcionado.

10. Haga clic en Finalizar para crear el EDM.

    El Asistente para Entity Data Model hace lo siguiente:

    • Agrega referencias a los ensamblados System.Data, System.Data.Entity, System.Core, System.Runtime.Serialization y System.Security al proyecto, si aún no existen.

    • Genera un archivo .edmx que encapsula el modelo de almacenamiento, el modelo conceptual y las asignaciones.

    • Crea un archivo de código fuente que contiene las clases que se generaron a partir del modelo conceptual. Para ver el archivo de código fuente, expanda el nodo .edmx en el Explorador de soluciones. Para ver el archivo de código fuente en los proyectos de Visual Basic, debe hacer clic en el botón Mostrar todos los archivos en el Explorador de soluciones antes de expandir el nodo .edmx.

    Nota

    El archivo de código fuente se genera a partir del archivo .edmx. Todos los cambios manuales que se realicen en el archivo de código fuente se sobrescribirán cuando el archivo .edmx correspondiente cambie. Para evitar que el código personalizado se sobrescriba, puede escribir clases parciales que se almacenen en archivos independientes. Para obtener más información, vea Personalizar objetos (Entity Framework).

    • Crea un archivo App.Config o Web.Config (según el tipo de proyecto).

    • Con los proyectos de sitio web ASP.NET, define un proveedor de compilación en el archivo Web.config.

    • Muestra el EDM en ADO.NET Entity Data Model Designer (Entity Designer). Para obtener información sobre cómo modificar un modelo con Entity Designer, vea Tareas de herramientas de Entity Data Model y Escenarios de ADO.NET Entity Data Model Designer.

Para obtener un ejemplo en el que se crea un modelo real a partir de una base de datos existente, vea Tutorial rápido (Entity Framework).

Para crear un modelo vacío

1. Abra o cree el proyecto para el que desea crear un EDM.

2. En el Explorador de soluciones, haga clic con el botón secundario en el nombre del proyecto, seleccione Agregar y, a continuación, haga clic en Nuevo elemento.

3. Seleccione ADO.NET Entity Data Model en el panel Plantillas.

4. Escriba el nombre para el modelo (<nombre de proyecto.edmx)> y, a continuación, haga clic en Agregar.

   Aparece la primera página del Asistente para Entity Data Model.

5. Seleccione Modelo vacío en el cuadro de diálogo Elegir contenido de Model y, a continuación, haga clic en Finalizar.

   El Asistente para Entity Data Model hace lo siguiente:

   • Agrega referencias a los ensamblados System.Data, System.Data.Entity, System.Core, System.Runtime.Serialization y System.Security al proyecto, si aún no existen.

   • Genera un archivo .edmx para encapsular el modelo de almacenamiento, el modelo conceptual y las asignaciones.

   Nota
   El archivo .edmx generado no tiene información de almacenamiento, conceptual o de asignación. Para saber cómo agregar información al modelo modificando este archivo, vea Entity Data Model, Especificaciones del EDM y Especificación de asignaciones y esquemas (Entity Framework).

   • Crea un archivo de código fuente vacío para contener las clases que se generan a partir del modelo conceptual. Para ver el archivo de código fuente, expanda el nodo .edmx en el Explorador de soluciones. Para ver el archivo de código fuente en los proyectos de Visual Basic, debe hacer clic en el botón Mostrar todos los archivos en el Explorador de soluciones antes de expandir el nodo .edmx.

   Nota
   El archivo de código fuente se genera a partir del archivo .edmx. Todos los cambios manuales que se realicen en el archivo de código fuente se sobrescribirán cuando el archivo .edmx correspondiente cambie.

   • Crea un archivo App.Config o Web.Config (según el tipo de proyecto).

   • Inicia Entity Designer, que proporciona una superficie de diseño para modificar el modelo. Para obtener información sobre cómo generar un modelo con Entity Designer, vea Tareas de herramientas de Entity Data Model y Escenarios de ADO.NET Entity Data Model Designer.

Vea también

Conceptos

Crear una aplicación con un Entity Data Model

Otros recursos

Tareas de herramientas de Entity Data Model