Gewusst wie: Erstellen einer neuen EDMX-Datei (Entity Data Model-Tools)
In diesem Thema wird beschrieben, wie Sie mit dem Assistent für Entity Data Model eine neue EDMX-Datei erstellen. Eine EDMX-Datei enthält das konzeptionelle Modell, das Speichermodell und die Zuordnungen zwischen ihnen. In den Verfahren in diesem Thema wird beschrieben, wie anhand einer vorhandenen Datenbank eine EDMX-Datei generiert und eine leere EDMX-Datei erstellt wird.
Hinweis: |
---|
Nachdem Sie eine leere EDMX-Datei generiert haben, können Sie mit dem ADO.NET Entity Data Model Designer (Entity Designer) Entitäten und Beziehungen erstellen.Dann können Sie mithilfe des Assistenten zur Datenbankenerstellung eine Datenbank aus der EDMX-Datei generieren.Weitere Informationen finden Sie unter Gewusst wie: Generieren einer Datenbank aus einem konzeptionellen Modell (Entity Data Model-Tools). |
Weitere Informationen zu EDMX-Dateien finden Sie unter Übersicht über die EDMX-Datei (Entity Framework). In folgende Visual Studio-Projektkategorien kann eine EDMX-Datei eingefügt werden:
Anwendungsprojekte
Klassenbibliotheken
Webprojekte
Einem Projekt können verschiedene EDMX-Dateien hinzugefügt werden. Dabei kann jede Datei eine andere Datenbank, unterschiedliche Tabellen in der gleichen Datenbank oder beide Optionen verwenden.
So erstellen Sie eine EDMX-Datei aus einer vorhandenen Datenbank
Öffnen oder erstellen Sie das Projekt, für das Sie die EDMX-Datei erstellen möchten.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Projektnamen, klicken Sie auf Hinzufügen und anschließend auf Neues Element.
Wählen Sie im Bereich Vorlagen das ADO.NET Entity Data Model aus.
Geben Sie den Namen für die Datei (<Projektname>.edmx) ein, und klicken Sie dann auf Hinzufügen.
Die erste Seite vom Assistent für Entity Data Model wird angezeigt.
Wählen Sie im Dialogfeld Modellinhalte auswählen die Option Aus Datenbank generieren aus, und klicken Sie dann auf Weiter.
Klicken Sie auf die Schaltfläche Neue Verbindung.
Das Dialogfeld Verbindungseigenschaften wird angezeigt.
Geben Sie den Servernamen ein, wählen Sie die Authentifizierungsmethode aus, und geben Sie den Namen der Datenbank ein, für die das Modell erstellt wird. Klicken Sie auf OK.
Das Dialogfeld Wählen Sie Ihre Datenverbindung aus wird mit den Verbindungseinstellungen für die Datenbank aktualisiert.
Hinweis: In der Standardeinstellung werden (je nach Projekttyp) Entitätsverbindungseinstellungen in der Datei App.config oder Web.config gespeichert.Geben Sie einen Namen für die Verbindung ein, oder verwenden Sie den angegebenen Standardnamen.Deaktivieren Sie das Kontrollkästchen Speichern Sie die Entitätsverbindungseinstellungen in App.Config/Web.Config als, wenn die Verbindungsinformationen nicht in einer Konfigurationsdatei gespeichert werden sollen.Weitere Informationen zum Speichern von Verbindungseinstellungen finden Sie unter Wählen Sie Ihre Datenverbindung aus (Dialogfeld im Assistenten für Entity Data Model). Klicken Sie auf Weiter, um den Vorgang fortzusetzen.
Das Dialogfeld Wählen Sie Ihre Datenbankobjekte aus wird angezeigt. In der Standardeinstellung sind in der Datenbank keine Objekte zum Einfügen in die EDMX-Datei ausgewählt.
Erweitern Sie die Knoten für Tabellen, Sichten und Gespeicherte Prozeduren. Deaktivieren Sie die Auswahl der Tabellen, Sichten und gespeicherten Prozeduren, die nicht in die EDMX-Datei eingefügt werden sollen.
Hinweis: Vom konzeptionellen Modell erstellte Klassen gehören zum Modellnamespace.Geben Sie einen Namen für den Namespace ein, oder verwenden Sie den angegebenen Standardnamen.Weitere Informationen finden Sie unter Übersicht über generierten Code (Entity Data Model Designer). Klicken Sie auf Fertig stellen, um die EDMX-Datei zu erstellen.
Der Assistent für Entity Data Model führt folgende Aktionen aus:
Fügt dem Projekt Verweise auf die Assemblys System.Data, System.Data.Entity, System.Core, System.Security und System.Runtime.Serialization hinzu, wenn sie nicht bereits vorhanden sind.
Erstellt eine EDMX-Datei, die das Speichermodell, das konzeptionelle Modell und Mappings kapselt.
Erstellt eine Quellcodedatei mit Klassen, die auf Grundlage des konzeptionellen Modells erstellt wurden. Sie können die Quellcodedatei anzeigen, indem Sie den EDMX-Knoten im Projektmappen-Explorer erweitern. Wenn Sie die Quellcodedatei in Visual Basic-Projekten anzeigen möchten, müssen Sie vor Erweitern des EDMX-Knotens im Projektmappen-Explorer auf die Schaltfläche Alle Dateien anzeigen klicken.
Hinweis: Die Quellcodedatei wird aus der EDMX-Datei generiert.Alle manuellen Änderungen an der Quellcodedatei werden überschrieben, wenn sich die entsprechende EDMX-Datei ändert.Um ein Überschreiben von benutzerdefiniertem Code zu verhindern, können Sie partielle Klassen schreiben, die in separaten Dateien gespeichert werden.Weitere Informationen finden Sie unter Customizing Objects (Entity Framework). Erstellt, je nach Projekttyp, eine App.Config- oder Web.Config-Datei
Definiert für ASP.NET-Websiteprojekte einen Buildanbieter in der Web.Config-Datei
Zeigt das konzeptionelle Modell im ADO.NET Entity Data Model-Designer (Entity Designer) an. Informationen zum Ändern des Modells mit dem Entity Designer finden Sie unter Aufgaben der Entity Data Model-Tools und Szenarien für die Verwendung der Entity Data Model-Tools.
Ein Beispiel für das Erstellen eines tatsächlichen Modells aus einer vorhandenen Datenbank finden Sie unter Quickstart (Entity Framework).
So erstellen Sie eine leere EDMX-Datei
Öffnen oder erstellen Sie das Projekt, für das Sie die EDMX-Datei erstellen möchten.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Projektnamen, klicken Sie auf Hinzufügen und anschließend auf Neues Element.
Wählen Sie im Bereich Vorlagen das ADO.NET Entity Data Model aus.
Geben Sie den Namen für die Datei (<Projektname>.edmx) ein, und klicken Sie dann auf Hinzufügen.
Die erste Seite vom Assistent für Entity Data Model wird angezeigt.
Wählen Sie im Dialogfeld Modellinhalte auswählen die Option Leeres Modell aus, und klicken Sie dann auf Fertig stellen.
Der Assistent für Entity Data Model führt folgende Aktionen aus:
Fügt dem Projekt Verweise auf die Assemblys System.Data, System.Data.Entity, System.Core, System.Security und System.Runtime.Serialization hinzu, wenn sie nicht bereits vorhanden sind
Erstellt eine EDMX-Datei, die das Speichermodell, das konzeptionelle Modell und Mappings kapselt.
Hinweis: Die erstellte EDMX-Datei enthält keine Speicher-, konzeptionellen oder Zuordnungsinformationen.Weitere Informationen zum manuellen Ändern dieser Datei finden Sie unter Mapping Schemas and Storage Metadata (EDM).Informationen zum Generieren einer Datenbank aus einem konzeptionellen Modell finden Sie unter Assistent zur Datenbankgenerierung (Entity Data Model-Tools) und Gewusst wie: Generieren einer Datenbank aus einem konzeptionellen Modell (Entity Data Model-Tools) - Erstellt eine leere Quellcodedatei für Klassen, die auf Grundlage des konzeptionellen Modells erstellt wurden. Sie können die Quellcodedatei anzeigen, indem Sie den EDMX-Knoten im Projektmappen-Explorer erweitern. Wenn Sie die Quellcodedatei in Visual Basic-Projekten anzeigen möchten, müssen Sie vor Erweitern des EDMX-Knotens im Projektmappen-Explorer auf die Schaltfläche Alle Dateien anzeigen klicken.
Hinweis: Die Quellcodedatei wird aus der EDMX-Datei generiert.Alle manuellen Änderungen an der Quellcodedatei werden überschrieben, wenn sich die entsprechende EDMX-Datei ändert. Erstellt, je nach Projekttyp, eine App.Config- oder Web.Config-Datei
Startet den Entity Designer, der eine Entwurfsoberfläche zum Bearbeiten des Modells bereitstellt. Informationen zum Erstellen des Modells mit dem Entity Designer finden Sie unter Aufgaben der Entity Data Model-Tools und Szenarien für die Verwendung der Entity Data Model-Tools.
Siehe auch
Konzepte
Erstellen einer Anwendung mit einem konzeptionellen Modell (Entity Data Model-Tools)