<\/p>\n
Wenn Sie ein Code First-Entity Data Model entwerfen, gibt es bestimmte Konventionen, die standardmäßig greifen. So heißen Entitäten wie der Singular der zugrunde liegenden Tabellennamen oder der Primär- und Fremdschlüssel werden aus Feldern abgeleitet, welche die Zeichenkette ID enthalten – gegebenenfalls kombiniert mit dem Entitätsnamen. Wenn Sie mit einem Datenmodell daherkommen, dessen Tabellen das Präfix “tbl” mitbringen, wollen Sie dieses nicht in den Entitätsnamen wiederfinden und gegebenenfalls möchten (oder müssen) Sie auch noch Feldnamen ändern und diese anschließend mappen. Eine Möglichkeit dazu finden Sie in den Methoden der Fluent Api, die wir in diesem Artikel beschreiben.<\/b><\/p>\nWarum Mapping zwischen Datenmodell und Entitäten<\/h2>\n
Wenn Sie ein Entity Data Model auf Basis des Datenmodells einer Datenbank erstellen oder andersherum, ist immer eine bestimmte Art von Mapping erforderlich. Im Optimalfall sind die Tabellen- und Feldnamen genau so eingestellt, dass diese den DbSet- und Entitätsnamen entsprechen. <\/p>\n
Sobald Sie aber ein Datenmodell erhalten, das beispielsweise Tabellennamen mit dem Präfix tbl <\/b>(wie tblArtikel<\/b>) enthält und wo die Feldnamen vielleicht nicht den Wünschen des Entwicklers für die Eigenschaften der Entitäten entsprechen, müssen Sie diese auf irgendeine Weise anpassen. Das Datenmodell anzupassen wäre toll, aber in manchen Fällen greifen noch andere Anwendungen auf die Datenbank zu, sodass Sie die Namen von Tabellen und Feldern nicht einfach ändern können.<\/p>\n
Also stellt das Entity Framework Möglichkeiten bereit, das Mapping zwischen den Tabellen und Feldern auf der einen und den DbSets und Eigenschaften auf der anderen Seite anzupassen.<\/p>\n
Dabei kann das Mapping für verschiedene Zwecke genutzt werden:<\/p>\n
Die Fluent API des Entity Frameworks bietet Methoden, die genau an einer Stelle innerhalb des Entity Data Models ausgeführt werden: in der Überschreibung der Methode OnModelCreating <\/b>der DbContext<\/b>-Klasse. Entity Framework ruft diese Methode beim Erstellen des Entity Data Models auf und führt die dort angegebenen Anweisungen zum Anpassen des Mappings aus.<\/p>\nBeispielprojekt<\/h2>\n
Das Beispielprojekt erstellen wir als neues Projekt des Typs WPF-App (.NET Framework) <\/b>für Visual Basic. Damit wir die nun zu erstellenden Elemente in eine Datenbank übertragen können, fügen wir dem Projekt ein neues Element des Typs ADO.NET Entity Data Model <\/b>hinzu und nennen dieses FluidAPIContext<\/b> (siehe Bild 1).<\/p>\n
![\"Entity](\"..\/fileadmin\/_temp_\/2021_01\/pic_252_002.png\")
<\/p>\n
Bild 1: Entity Data Model hinzufügen<\/span><\/b><\/p>\n Dabei verwenden wir als Vorlage Leeres Code First-Modell <\/b>(siehe Bild 2). Nach einem Klick auf die Schaltfläche Fertigstellen<\/b> erhalten wir im Projektmappen-Explorer ein neues Element namens FluidAPIContext.vb <\/b>sowie ein paar neue Einträge in der Datei App.config <\/b>– zum Beispiel die Verbindungszeichenfolge zum Erstellen beziehungsweise für den Zugriff auf die Datenbank für diese Lösung.<\/p>\n Bild 2: Neues Entity Data Model als leeres Code First-Modell<\/span><\/b><\/p>\n Zu einer einfachen Tabelle gehört ein eindeutiges Primärschlüsselfeld mit Autowert-Funktion sowie die benötigten Felder. Wir beginnen mit einer Entität, auf deren Basis eine Tabelle namens Anreden <\/b>entstehen soll. Diese soll die Felder ID <\/b>und Name <\/b>enthalten. Dazu legen wir eine neue Klassendatei namens Anrede.vb <\/b>an. Der Code der Klasse lautet vorerst:<\/p>\n Für dieses Element fügen wir der DbContext<\/b>-Klasse eine Auflistung hinzu:<\/p>\n Um daraus die Datenbank mit der ersten Tabelle zu erstellen, benötigen wir die Paket-Manager-Konsole, die wir mit dem Befehl Extras|NuGet-Paketmanager|Paket-Manager-Konsole <\/b>anzeigen. In der Konsole setzen Sie nacheinander die folgenden Anweisungen ab:<\/p>\n Dies erstellt die neue Datenbank und eine Tabelle, die wir uns im SQL Server Management Studio anschauen können (den Zielserver und den Namen der Datenbank können Sie der Verbindungszeichenfolge in der Datei App.config <\/b>entnehmen). Das Ergebnis sieht wie in Bild 3 aus.<\/p>\n Bild 3: Die neue Tabelle in der frisch erzeugten Datenbank<\/span><\/b><\/p>\n Hier erkennen wir gleich, dass bei der Erstellung der Tabelle einige Konventionen umgesetzt wurden. So hat Entity Framework automatisch erkannt, dass die Eigenschaft ID <\/b>wohl als Primärschlüsselfeld mit Autowertfunktion verwendet werden soll. Außerdem hat es das Feld Name <\/b>als Feld mit dem Datentyp nvarchar(MAX) <\/b>angelegt, der Nullwerte erlaubt. Als Tabellenname hat Entity Framework aus der Entitätsklasse namens Anrede <\/b>den Namen Anredes <\/b>erzeugt.<\/p>\n Dies resultiert ebenfalls aus einer Konvention, die dafür sorgt, dass Entity Framework den Tabellenamen aus dem Namen der Entitätsklasse plus dem s <\/b>für den englischen Plural zusammenstellt.<\/p>\n In den folgenden Abschnitten schauen wir uns an, wie wir diese Konventionen durch Verwendung von Elementen der FluentAPI für das Entity Framework umgehen und mit eigenen Konventionen ersetzen können. Wir wollen zunächst die folgenden Dinge ändern:<\/p>\n Als Erstes setzen wir die Konvention außer Kraft, die dafür sorgt, dass die zu erstellende Tabelle den Namen der Entitätsklasse plus dem Plural-s als Bezeichnung erhält. Dazu fügen wir der Klasse FluentApiContext <\/b>die Methode OnModelCreating <\/b>hinzu und legen dort eine Anweisung an, welche die Konvention aufhebt:<\/p>\n Um den Typ PluralizingTableNameConvention <\/b>zu nutzen, fügen wir einen weiteren Namespace zu der Klassendatei hinzu:<\/p>\n Nun aktualisieren wir das Datenmodell, indem wir die folgenden beiden Anweisungen in der Paket-Manager-Konsole aufrufen:<\/p>\n Danach finden wir die Tabelle in der Datenbank unter dem Namen Anrede <\/b>vor. Wir möchten allerdings den Namen Anreden <\/b>oder auch tblAnreden<\/b>. Dazu fügen wir der Methode OnModelCreating <\/b>eine weitere Anweisung hinzu:<\/p>\n Wenn Sie den Namen tblAnreden <\/b>verwenden möchten, nutzen Sie einfach folgende Anweisung:<\/p>\n Um diese Änderungen durchzuführen, rufen Sie immer wieder die beiden Anweisungen in der Paket-Manager-Konsole auf – wir weisen in den folgenden Abschnitten nicht mehr explizit darauf hin. Außerdem müssen Sie, um die Änderungen in der SQL Server Management Konsole zu sehen, das Element Tables <\/b>über den Kontextmenü-Eintrag Refresh <\/b>aktualisieren.<\/p>\n Möchten Sie weiterlesen? Dann lösen Sie Ihr Ticket!<\/span>![\"Neues](\"..\/fileadmin\/_temp_\/2021_01\/pic_252_001.png\")
<\/p>\nEinfache Tabelle erstellen<\/h2>\n
Public Class<\/span> Anrede\r\n Public <\/span>Property ID As Integer<\/span>\r\n Public <\/span>Property Name As String<\/span>\r\nEnd Class<\/span><\/pre>\nPublic Class<\/span> FluidAPIContext\r\n Inherits DbContext\r\n Public <\/span>Sub New()\r\n MyBase.New(\"name=FluidAPIContext\")\r\n End Sub\r\n Public <\/span>Overridable Property Anreden As <\/span>DbSet(Of Anrede)\r\nEnd Class<\/span><\/pre>\n\n
![\"Die](\"..\/fileadmin\/_temp_\/2021_01\/pic_252_003.png\")
<\/p>\nEingesetzte Konventionen<\/h2>\n
Umgehen der Konventionen<\/h2>\n
\n
Anpassen des Tabellennamens<\/h2>\n
Public Class<\/span> FluidAPIContext\r\n Inherits DbContext\r\n ...\r\n Public <\/span>Overridable Property Anreden As <\/span>DbSet(Of Anrede)\r\n Protected Overrides Sub OnModelCreating(ByVal modelBuilder As <\/span>DbModelBuilder)\r\n modelBuilder.Conventions.Remove(Of PluralizingTableNameConvention)()\r\n End Sub\r\nEnd Class<\/span><\/pre>\nImports System.Data.Entity.ModelConfiguration.Conventions<\/pre>\n
Add-Migration Init\r\nUpdate-Database<\/pre>\n
modelBuilder.Entity(Of Anrede)().ToTable(\"Anreden\")<\/pre>\n
modelBuilder.Entity(Of Anrede)().ToTable(\"tblAnreden\")<\/pre>\n
Anpassen des String-Felddatentyps<\/h2>\n
\nHier geht es zur Bestellung des Jahresabonnements des Magazins Visual Basic Entwickler<\/strong>:<\/span>
\nZur Bestellung ...<\/a><\/span>
\nDanach greifen Sie sofort auf alle rund 200 Artikel<\/strong> unseres Angebots zu - auch auf diesen hier!<\/span>
\nOder haben Sie bereits Zugangsdaten? Dann loggen Sie sich gleich hier ein:<\/span><\/p>\n<\/div>\n\n\t\n\t