Esta documentación está archivada y no tiene mantenimiento.

Cómo: Crear un nuevo archivo .edmx (Entity Data Model Tools)

En este tema se describe cómo crear un nuevo archivo .edmx mediante el Asistente para Entity Data Model. Un archivo .edmx contiene el modelo conceptual, así como un modelo de almacenamiento y las asignaciones entre ellos. En los procedimientos de este tema se describe cómo generar un archivo .edmx basado en una base de datos existente y cómo generar un archivo .edmx vacío.

Cc716703.note(es-es,VS.100).gifNota:
Después de generar un archivo .edmx vacío, puede usar ADO.NET Entity Data Model Designer (Entity Designer) para crear entidades y relaciones. Después, puede usar el Asistente para crear bases de datos con el fin de generar una base de datos a partir del archivo .edmx. Para obtener más información, vea Cómo: Generar una base de datos a partir de un modelo conceptual (Herramientas de Entity Data Model).

Para obtener más información sobre los archivos .edmx, vea Información general sobre el archivo .edmx (Entity Framework). Un archivo .edmx puede incluirse en las siguientes categorías de proyecto de Visual Studio:

  • Proyectos de aplicación

  • Bibliotecas de clases

  • Proyectos web

Se pueden agregar varios archivos .edmx al mismo proyecto y cada uno puede estar destinado a una base de datos distinta, a tablas diferentes de la misma base de datos o a ambas.

Para crear un archivo .edmx a partir de una base de datos existente

  1. Abra o cree el proyecto para el que desee crear un archivo .edmx.

  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 recuadro Plantillas.

  4. Escriba el nombre del archivo (<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.

    Cc716703.note(es-es,VS.100).gifNota:
    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 Elegir la conexión de datos (Cuadro de diálogo) (Asistente para Entity Data Model).

  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 archivo .edmx.

  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 archivo .edmx.

    Cc716703.note(es-es,VS.100).gifNota:
    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. Para obtener más información, vea Información general sobre el código generado (Entity Data Model Designer).

  10. Haga clic en Finalizar para crear el archivo .edmx.

    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.

    Cc716703.note(es-es,VS.100).gifNota:
    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 Customizing Objects (Entity Framework).

Para obtener un ejemplo en el que se cree un modelo real a partir de una base de datos existente, vea Quickstart (Entity Framework).

Para crear un archivo .edmx vacío

  1. Abra o cree el proyecto para el que desee crear un archivo .edmx.

  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 recuadro Plantillas.

  4. Escriba el nombre del archivo (<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.

    Cc716703.note(es-es,VS.100).gifNota:
    El archivo .edmx generado no tiene información de almacenamiento, conceptual ni de asignación. Para obtener más información acerca de cómo modificar manualmente este archivo, vea Mapping Schemas and Storage Metadata (EDM). Para obtener información sobre una base de datos a partir de un modelo conceptual, vea Asistente para generar base de datos (Herramientas de Entity Data Model) y Cómo: Generar una base de datos a partir de un modelo conceptual (Herramientas de Entity Data Model).

    • 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.

    Cc716703.note(es-es,VS.100).gifNota:
    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.

Vea también

Mostrar: