Übersicht über die EDMX-Datei (Entity Framework)

  • Artikel

Eine EDMX-Datei ist eine XML-Datei, die ein konzeptionelles Modell, ein Speichermodell und das Mapping zwischen diesen Modellen definiert. Eine EDMX-Datei enthält auch Informationen, die vom ADO.NET Entity Data Model Designer (Entity Designer) verwendet werden, um ein Modell grafisch zu rendern. Die empfohlene Vorgehensweise für das Erstellen einer EDMX-Datei ist die Verwendung des Assistenten für Entity Data Model. Weitere Informationen finden Sie unter Gewusst wie: Erstellen einer neuen EDMX-Datei (Entity Data Model-Tools).

An einer EDMX-Datei werden Änderungen vorgenommen, wenn Sie das Modell mit dem Entity Designer ändern und das Modell auf Grundlage der Änderungen an der zugrunde liegenden Datenbank mithilfe des Modellaktualisierungs-Assistenten aktualisieren. Weitere Informationen finden Sie unter Modellaktualisierungs-Assistent (Entity Data Model-Tools). In einigen Szenarien muss eine EDMX-Datei möglicherweise auch manuell bearbeitet werden. Weitere Informationen finden Sie unter Manuelle Bearbeitung einer EDMX-Datei (Entity Framework).

EDMX-Dateien werden standardmäßig mit dem Entity Designer geöffnet. Sie können eine EDMX-Datei jedoch wie folgt mit dem XML-Editor öffnen:

  1. Stellen Sie sicher, dass das Projekt in Visual Studio geöffnet ist.

  2. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf die EDMX-Datei, und wählen Sie Öffnen mit... aus.

  3. Wählen Sie XML-Editor aus, und klicken Sie auf OK.

Inhalt der EDMX-Datei

Im Folgenden sehen Sie eine allgemeine Aufstellung des Inhalts einer EDMX-Datei. Weitere Details finden Sie in den EDMX-Schemas im Visual Studio-XML-Verzeichnis.

Cc982042.note(de-de,VS.100).gifHinweis:
Das Schema für Anwendungen, die .NET Framework Version 4 als Ziel haben, ist in der Datei "Microsoft.Data.Entity.Design.Edmx_2.xsd" definiert.Das Schema für Anwendungen, die .NET Framework Version 3.5 SP1 als Ziel haben, ist in der Datei "Microsoft.Data.Entity.Design.Edmx_1.xsd" definiert.

Laufzeitinhalt (edmx:Runtime)

Dieser Abschnitt enthält Informationen, die verwendet werden, um Modell- und Zuordnungsdateien für Entity Framework-Anwendungen zu generieren. Weitere Informationen finden Sie unten im Abschnitt zu den EDMX-Dateieigenschaften in der Beschreibung der Eigenschaft Build Action.

Cc982042.note(de-de,VS.100).gifHinweis:
Einer Anwendung, die auf einen ADO.NET Data Services-Dienst verweist, wird automatisch eine EDMX-Datei hinzugefügt.In diesem Fall enthält die EDMX-Datei keinen edmx:Runtime-Knoten, sondern einen edmx:DataServices-Knoten.Weitere Informationen finden Sie unter ADO.NET Data Services Framework.

  • Inhalt des Speichermodells (edmx:StorageModels): In diesem Abschnitt wird das Zieldatenbankschema beschrieben. Dieser Abschnitt ist in der Datenspeicherschema-Definitionssprache (SSDL) geschrieben. Weitere Informationen finden Sie unter SSDL Specification und EntityContainer Element (SSDL).

  • Inhalt des konzeptionellen Modells (edmx:ConceptualModels): In diesem Abschnitt werden die Entitätstypen, komplexen Typen, Zuordnungen, Entitätencontainer, Entitätenmengen und Zuordnungssätze in der Anwendungsdomäne definiert. Dieser Abschnitt ist in der konzeptionellen Schemadefinitionssprache (CSDL) geschrieben. Weitere Informationen finden Sie unter CSDL Specification und EntityContainer Element (CSDL).

  • Mappinginhalt (edmx:Mappings): In diesem Abschnitt wird das Mapping zwischen dem konzeptionellen Modell und der Zieldatenbank beschrieben. Dieser Abschnitt ist in der Mapping-Spezifikationssprache (MSL) geschrieben. Weitere Informationen finden Sie unter MSL Specification.

Designerinhalt (edmx:Designer)

Dieser Abschnitt enthält Informationen, die vom Entity Designer verwendet werden, um ein konzeptionelles Modell grafisch zu rendern und einige Eigenschaften des konzeptionellen Modells und Entwurfszeiteigenschaften zu definieren.

Cc982042.note(de-de,VS.100).gifHinweis:
Einer Anwendung, die auf einen ADO.NET Data Services-Dienst verweist, wird automatisch eine EDMX-Datei hinzugefügt.In diesem Fall enthält die EDMX-Datei keinen edmx:Designer-Knoten und kann nicht mit dem Entity Designer angezeigt werden.Weitere Informationen finden Sie unter ADO.NET Data Services Framework.

  • Verbindungsinhalt (edmx:Connection): In diesem Abschnitt werden Eigenschaften des konzeptionellen Modells beschrieben, die sich auf die Verbindungszeichenfolge auswirken. Gegenwärtig kann in diesem Abschnitt nur die MetadataArtifactProcessing-Eigenschaft festgelegt werden. Weitere Informationen finden Sie unter Connection Strings.

  • Optionsinhalt (edmx:Options): In diesem Abschnitt werden optionale Eigenschaften des konzeptionellen Modells beschrieben. Gegenwärtig wird hier nur die ValidateOnBuild-Eigenschaft festgelegt.

  • Diagramme (edmx:Diagrams): Dieser Abschnitt enthält Informationen, die vom Entity Designer verwendet werden, um eine grafische Darstellung des konzeptionellen Modells zu rendern.

Eigenschaften des konzeptionellen Modells

Die Eigenschaften eines konzeptionellen Modells werden in einer EDMX-Datei definiert. Die folgende Liste enthält die Eigenschaften des konzeptionellen Modells, die im Visual Studio-Fenster Eigenschaften sichtbar sind:

Cc982042.note(de-de,VS.100).gifHinweis:
Die Eigenschaften des konzeptionellen Modells und die Eigenschaften der EDMX-Datei selbst sind nicht das Gleiche.Weitere Informationen finden Sie unten im Abschnitt zu .edmx File Properties.

  • Connection String
    Die Verbindungszeichenfolge des Entitätsclients. Die angezeigte Verbindungszeichenfolge stammt aus der Datei "App.config" oder "Web.Config" des Projekts und besitzt den gleichen Namen wie der Entitätencontainer. Weitere Informationen finden Sie unter Connection Strings.
  • Database Schema Name
    Der Name des Datenbankschemas, das beim Erstellen einer Datenbank aus einem konzeptionellen Modell generiert wird.
  • Entity Container Access
    Steuert, ob die generierte Objektkontextklasse Öffentlich oder Intern ist.
  • Entity Container Name
    Der Name des Entitätencontainers des konzeptionellen Modells. Weitere Informationen finden Sie unter EntityContainer Element (CSDL).
  • Metadata Artifact Processing
    Steuert, ob die Modell- und Zuordnungsdateien (CSDL-, SSDL- und MSL-Dateien) in eine Ausgabeassembly eingebettet oder in das Ausgabeverzeichnis kopiert werden.
  • Namespace
    Der Namespace für das konzeptionelle Modell. Weitere Informationen finden Sie unter Schema Element (CSDL).
  • Pluralize New Objects
    Steuert, ob neue Entitätenmengennamen und Navigationseigenschaftennamen in den Plural gesetzt werden.
  • Transform Related Text Templates On Save
    Textvorlagen werden mit einer EDMX-Datei verknüpft, indem der EDMX-Dateiname in die Textvorlage eingefügt wird. Weitere Informationen finden Sie unter Gewusst wie: Anpassen der Generierung von Objektebenencode (Entity Data Model Designer). Wenn die Eigenschaft Transform Related Text Templates On Save auf True festgelegt ist, werden alle mit der EDMX-Datei verknüpften Textvorlagen beim Speichern der EDMX-Datei verarbeitet. Ist die Eigenschaft auf False festgelegt, wird keine der verknüpften Textvorlagen verarbeitet.
  • Validate On Build
    Steuert, ob das Modell beim Erstellen des Projekts überprüft wird.

EDMX-Dateieigenschaften

Die Eigenschaften Build Action, Custom Tool und Custom Tool Namespace sind Eigenschaften einer EDMX-Datei. Weitere Information zu den Eigenschaften Copy to Output Directory und File Name einer EDMX-Datei finden Sie im Abschnitt zu Dateieigenschaften in der Visual Studio-Dokumentation (möglicherweise in englischer Sprache).

Cc982042.note(de-de,VS.100).gifHinweis:
Die Dateieigenschaft Copy to Output Directory wird nicht verwendet, um festzulegen, dass Modell- und Zuordnungsdateien in das Ausgabeverzeichnis kopiert werden sollen.Verwenden Sie stattdessen die Eigenschaft Metadata Artifact Processing des konzeptionellen Modells.

Gehen Sie folgendermaßen vor, um EDMX-Dateieigenschaften in Visual Studio anzuzeigen und zu bearbeiten:

  1. Öffnen Sie in Visual Studio ein Projekt, das eine EDMX-Datei enthält.

  2. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf die EDMX-Datei, und wählen Sie Eigenschaften aus.

    Die Dateieigenschaften werden im Fenster Eigenschaften angezeigt.

In der folgenden Liste werden die Eigenschaften Build Action, Custom Tool und Custom Tool Namespace einer EDMX-Datei beschrieben:

  • Build Action
    Wenn diese Eigenschaft auf EntityDeploy (Standardwert) festgelegt ist, werden beim Buildvorgang drei Dateien aus der EDMX-Datei erstellt: die Datei des konzeptionellen Modells (.csdl), die Speichermodelldatei (.ssdl) und die Zuordnungsdatei (.msl). Diese Dateien werden abhängig vom Wert der Eigenschaft Metadata Artifact Processing des Modells als Ressourcen eingebettet oder in das Ausgabeverzeichnis kopiert. Weitere Informationen finden Sie unter Gewusst wie: Bearbeiten der Eigenschaften des konzeptionellen Modells (Entity Data Model-Tools). Informationen zu anderen Werten der Eigenschaft Build Action finden Sie im Thema zu Dateieigenschaften (möglicherweise in englischer Sprache).
  • Custom Tool
    Wenn der Wert dieser Eigenschaft EntityModelCodeGenerator lautet (Standardwert) und Codegenerierungsstrategie auf Standard festgelegt ist, erstellt der Entity Designer eine Quellcodedatei mit Klassen, die aus dem in der EDMX-Datei definierten konzeptionellen Modell generiert wurden. Weitere Informationen finden Sie unter Übersicht über generierten Code (Entity Data Model Designer).
  • Custom Tool Namespace
    Diese Eigenschaft ist standardmäßig leer. Wenn Sie einen Wert angeben, dient er als Namespace für den Code, der von dem in der Eigenschaft Custom Tool angegebenen Tool generiert wird. Weitere Informationen finden Sie unter Übersicht über generierten Code (Entity Data Model Designer).

Siehe auch

Konzepte

Übersicht über generierten Code (Entity Data Model Designer)

Weitere Ressourcen

CSDL Specification