Enumerationsunterstützung – EF Designer

In diesem Video und der Schritt-für-Schritt-Anleitung wird gezeigt, wie Enum-Typen mit dem Entity-Framework-Designer verwendet werden. Außerdem wird veranschaulicht, wie Enums in einer LINQ-Abfrage verwendet werden.

In dieser exemplarischen Vorgehensweise wird "Model First" verwendet, um eine neue Datenbank zu erstellen, aber der EF-Designer kann auch mit dem Database First Workflow verwendet werden, um eine vorhandene Datenbank zuzuordnen.

Die Enumerationsunterstützung wurde in Entity Framework 5 eingeführt. Um die neuen Features wie Enumerationen, räumliche Datentypen und Tabellenwertfunktionen zu verwenden, müssen Sie .NET Framework 4.5 verwenden. Visual Studio 2012 zielt standardmäßig auf .NET 4.5 ab.

In Entity Framework kann eine Enumeration die folgenden zugrunde liegenden Typen aufweisen: Byte, Int16, Int32, Int64 oder SByte.

Video ansehen

In diesem Video wird gezeigt, wie Enum-Typen mit dem Entity Framework Designer verwendet werden. Außerdem wird veranschaulicht, wie Enums in einer LINQ-Abfrage verwendet werden.

Präsentiert von: Julia Kornich

Video: WMV | MP4 | WMV (ZIP)

Voraussetzungen

Sie müssen Visual Studio 2012, Ultimate, Premium, Professional oder Web Express Edition installiert haben, um diese exemplarische Vorgehensweise abzuschließen.

Einrichten des Projekts

1. Öffnen von Visual Studio 2012
2. Zeigen Sie im Menü "Datei " auf "Neu", und klicken Sie dann auf "Projekt".
3. Klicken Sie im linken Bereich auf Visual C#, und wählen Sie dann die Konsolenvorlage aus.
4. Geben Sie "EnumEFDesigner " als Namen des Projekts ein, und klicken Sie auf "OK".

Erstellen eines neuen Modells mithilfe des EF-Designers

1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Projektnamen, zeigen Sie auf "Hinzufügen", und klicken Sie dann auf "Neues Element".
2. Wählen Sie " Daten " im linken Menü und dann im Bereich "Vorlagen " ADO.NET Entitätsdatenmodell aus.
3. Geben Sie "EnumTestModel.edmx " für den Dateinamen ein, und klicken Sie dann auf "Hinzufügen".
4. Wählen Sie auf der Seite "Entitätsdatenmodell-Assistent" im Dialogfeld "Modellinhalt auswählen " die Option "Leeres Modell " aus.
5. Klicken Sie auf Fertig stellen.

Der Entitäts-Designer, der eine Entwurfsoberfläche zum Bearbeiten des Modells bereitstellt, wird angezeigt.

Der Assistent führt die folgenden Aktionen aus:

• Generiert die EnumTestModel.edmx-Datei, die das konzeptionelle Modell, das Speichermodell und die Zuordnung zwischen ihnen definiert. Legt die Eigenschaft 'Metadaten-Artefaktverarbeitung' der .edmx-Datei auf "In Ausgabeassembly einbetten" fest, sodass die generierten Metadatendateien in die Assembly eingebettet werden.
• Fügt einen Verweis auf die folgenden Assemblys hinzu: EntityFramework, System.ComponentModel.DataAnnotations und System.Data.Entity.
• Erstellt EnumTestModel.tt und EnumTestModel.Context.tt Dateien und fügt sie unter der edmx-Datei hinzu. Diese T4-Vorlagendateien generieren den Code, der den von DbContext abgeleiteten Typ und POCO-Typen definiert, die den Entitäten im edmx-Modell zugeordnet sind.

Hinzufügen eines neuen Entitätstyps

1. Klicken Sie mit der rechten Maustaste auf einen leeren Bereich der Entwurfsoberfläche, wählen Sie "Hinzufügen –> Entität" aus, das Dialogfeld "Neue Entität" wird angezeigt.
2. Geben Sie "Abteilung" für den Typnamen an, und geben Sie "DepartmentID" für den Schlüsseleigenschaftsnamen an, lassen Sie den Typ als "Int32" zurück.
3. Klicken Sie auf OK
4. Klicken Sie mit der rechten Maustaste auf die Entität, und wählen Sie "Neu hinzufügen "> Skalareigenschaft" aus.
5. Benennen Sie die neue Eigenschaft in "Name" um.
6. Ändern Sie den Typ der neuen Eigenschaft in Int32 (standardmäßig ist die neue Eigenschaft vom Typ String) Um den Typ zu ändern, öffnen Sie das Eigenschaftenfenster, und ändern Sie die Type-Eigenschaft in Int32.
7. Fügen Sie eine weitere skalare Eigenschaft hinzu, und benennen Sie sie in "Budget" um, ändern Sie den Typ in "Dezimal"

Hinzufügen eines Enum-Typs

1. Klicken Sie im Entity Framework-Designer mit der rechten Maustaste auf die Name-Eigenschaft und wählen Sie "In enum konvertieren" aus.

   

2. Geben Sie im Dialogfeld "Enumeration hinzufügen " " DepartmentNames " für den Enumerationstypnamen ein, ändern Sie den zugrunde liegenden Typ in Int32, und fügen Sie dann die folgenden Member zum Typ hinzu: Englisch, Mathematik und Wirtschaftswissenschaften

   

3. Drücken Sie "OK".

4. Speichern des Modells und Erstellen des Projekts

   Hinweis

   Beim Erstellen könnten Warnungen zu nicht zugeordneten Entitäten und Zuordnungen in der Fehlerliste erscheinen. Sie können diese Warnungen ignorieren, da nach der Auswahl, die Datenbank aus dem Modell zu generieren, die Fehler nicht mehr auftreten.

Wenn Sie sich das Eigenschaftenfenster ansehen, werden Sie feststellen, dass der Typ der Eigenschaft "Name" in "DepartmentNames " geändert wurde und der neu hinzugefügte Enumerationstyp der Liste der Typen hinzugefügt wurde.

Wenn Sie zum Fenster "Modellbrowser" wechseln, sehen Sie, dass der Typ auch dem Knoten "Enum-Typen" hinzugefügt wurde.

Datenbank anhand des Modells generieren

Jetzt können wir eine Datenbank generieren, die auf dem Modell basiert.

1. Klicken Sie mit der rechten Maustaste auf der Entitäts-Designer-Oberfläche auf ein leeres Leerzeichen, und wählen Sie "Datenbank aus Modell generieren" aus.
2. Das Dialogfeld 'Datenverbindung auswählen' des Assistenten 'Datenbank generieren' wird angezeigt, klicken Sie auf die Schaltfläche ' Neue Verbindung angeben '(localdb)\mssqllocaldb ' für den Servernamen und 'EnumTest ' für die Datenbank, und klicken Sie auf 'OK'.
3. Ein Dialogfeld, in dem Sie gefragt werden, ob eine neue Datenbank erstellt werden soll, klicken Sie auf "Ja".
4. Klicken Sie auf Weiter und der Assistent zum Erstellen von Datenbanken generiert Datendefinitionssprache (DDL) zum Erstellen einer Datenbank. Die generierte DDL wird im Dialogfeld "Zusammenfassung und Einstellungen" angezeigt. Beachten Sie, dass die DDL keine Definition für eine Tabelle enthält, die dem Enumerationstyp zugeordnet ist.
5. Klicken Sie auf Fertig. Das Klicken auf "Fertig" führt das DDL-Skript nicht aus.
6. Der Assistent zum Erstellen von Datenbanken führt folgendes aus: Öffnet die EnumTest.edmx.sql im T-SQL-Editor Generiert das Speicherschema und Zuordnungsabschnitte der EDMX-Datei fügt der App.config Datei Verbindungszeichenfolgeninformationen hinzu.
7. Klicken Sie im T-SQL-Editor mit der rechten Maustaste und wählen Sie Ausführen. Der Dialog "Verbinden mit Server" erscheint, geben Sie die Verbindungsinformationen aus Schritt 2 ein und klicken Sie auf Verbinden.
8. Um das generierte Schema anzuzeigen, klicken Sie im SQL Server-Objekt-Explorer mit der rechten Maustaste auf den Datenbanknamen, und wählen Sie "Aktualisieren" aus.

Speichern und Abrufen von Daten

Öffnen Sie die Program.cs Datei, in der die Main-Methode definiert ist. Fügen Sie der Hauptfunktion den folgenden Code hinzu. Der Code fügt dem Kontext ein neues Department-Objekt hinzu. Anschließend werden die Daten gespeichert. Der Code führt auch eine LINQ-Abfrage aus, die eine Abteilung zurückgibt, in der der Name "DepartmentNames.English" lautet.

using (var context = new EnumTestModelContainer())
{
    context.Departments.Add(new Department{ Name = DepartmentNames.English });

    context.SaveChanges();

    var department = (from d in context.Departments
                        where d.Name == DepartmentNames.English
                        select d).FirstOrDefault();

    Console.WriteLine(
        "DepartmentID: {0} and Name: {1}",
        department.DepartmentID,  
        department.Name);
}

Kompilieren Sie die Anwendung, und führen Sie sie aus. Das Programm erzeugt die folgende Ausgabe:

DepartmentID: 1 Name: English

Um Daten in der Datenbank anzuzeigen, klicken Sie im SQL Server-Objekt-Explorer mit der rechten Maustaste auf den Datenbanknamen, und wählen Sie "Aktualisieren" aus. Klicken Sie dann auf die rechte Maustaste auf der Tabelle, und wählen Sie "Daten anzeigen" aus.

Zusammenfassung

In dieser exemplarischen Vorgehensweise haben wir uns damit beschäftigt, wie Enum-Typen unter Verwendung des Entity Framework-Designers zugeordnet werden und Enums im Code verwenden.