DbModelBuilder Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
DbModelBuilder wird verwendet, um CLR-Klassen einem Datenbankschema zuzuordnen. Dieser codeorientierte Ansatz zum Erstellen eines Entity Data Model (EDM)-Modells wird als "Code First" bezeichnet.
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Naming", "CA1709:IdentifiersShouldBeCasedCorrectly", MessageId="Db")]
public class DbModelBuilder
public class DbModelBuilder
type DbModelBuilder = class
Public Class DbModelBuilder
- Vererbung
-
DbModelBuilder
- Attribute
Hinweise
DbModelBuilder wird in der Regel verwendet, um ein Modell durch Überschreiben von DbContext.OnModelCreating(DbModelBuilder) zu konfigurieren. Sie können DbModelBuilder auch unabhängig von DbContext verwenden, um ein Modell zu erstellen und dann ein DbContext oder zu ObjectContexterstellen. Der empfohlene Ansatz besteht jedoch darin, OnModelCreating zu DbContext verwenden, da der Workflow intuitiver ist und allgemeine Aufgaben übernimmt, z. B. das Zwischenspeichern des erstellten Modells. Typen, die Ihr Modell bilden, werden mit DbModelBuilder registriert und optionale Konfiguration kann durch Anwenden von Datenanmerkungen auf Ihre Klassen und/oder mithilfe der DbModelBuilder-API im Fluent-Stil ausgeführt werden. Wenn die Build-Methode als eine Reihe von Konventionen aufgerufen wird, werden ausgeführt, um das anfängliche Modell zu ermitteln. Diese Konventionen erkennen automatisch Aspekte des Modells, z. B. Primärschlüssel, und verarbeiten auch alle Datenanmerkungen, die in Ihren Klassen angegeben wurden. Schließlich wird jede Konfiguration angewendet, die mit der DbModelBuilder-API ausgeführt wurde. Die über die DbModelBuilder-API vorgenommene Konfiguration hat Vorrang vor Datenanmerkungen, die wiederum Vorrang vor den Standardkonventionen haben.
Konstruktoren
| Name | Beschreibung |
|---|---|
| DbModelBuilder() |
Initialisiert eine neue Instanz der DbModelBuilder-Klasse. Beim Ermitteln des ersten Modells werden die Konventionen verwendet, die in der neuesten Version des auf Ihrem Computer installierten Entity Frameworks enthalten sind. |
| DbModelBuilder(DbModelBuilderVersion) |
Initialisiert eine neue Instanz der DbModelBuilder Klasse, die einen bestimmten Satz von Konventionen verwendet, um das ursprüngliche Modell zu ermitteln. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Configurations |
Ruft den ConfigurationRegistrar für dieses DbModelBuilder ab. Die Registrierungsstelle ermöglicht die Registrierung abgeleiteter Entitäts- und komplexer Typkonfigurationen bei diesem Generator. |
| Conventions |
Bietet Zugriff auf die Einstellungen dieser DbModelBuilder, die Konventionen behandeln. |
Methoden
| Name | Beschreibung |
|---|---|
| Build(DbConnection) |
Erstellt eine DbModel basierende Konfiguration, die mit diesem Generator ausgeführt wurde. Die Verbindung wird verwendet, um den Datenbankanbieter zu bestimmen, der verwendet wird, da sich dies auf die Datenbankebene des generierten Modells auswirkt. |
| Build(DbProviderInfo) |
Erstellt eine DbModel basierende Konfiguration, die mit diesem Generator ausgeführt wurde. Anbieterinformationen müssen angegeben werden, da sich dies auf die Datenbankebene des generierten Modells auswirkt. Für SqlClient lautet der invariante Name "System.Data.SqlClient", und das Manifesttoken ist das Versionsjahr (z. B. "2005", "2008" usw.) |
| ComplexType<TComplexType>() |
Registriert einen Typ als komplexer Typ im Modell und gibt ein Objekt zurück, das zum Konfigurieren des komplexen Typs verwendet werden kann. Diese Methode kann mehrmals für denselben Typ aufgerufen werden, um mehrere Konfigurationsschritte vorzunehmen. |
| Entity<TEntityType>() |
Registriert einen Entitätstyp als Teil des Modells und gibt ein Objekt zurück, das zum Konfigurieren der Entität verwendet werden kann. Diese Methode kann mehrmals für dieselbe Entität aufgerufen werden, um mehrere Konfigurationsschritte vorzunehmen. |
| Equals(Object) |
DbModelBuilder wird verwendet, um CLR-Klassen einem Datenbankschema zuzuordnen. Dieser codeorientierte Ansatz zum Erstellen eines Entity Data Model (EDM)-Modells wird als "Code First" bezeichnet. |
| GetHashCode() |
DbModelBuilder wird verwendet, um CLR-Klassen einem Datenbankschema zuzuordnen. Dieser codeorientierte Ansatz zum Erstellen eines Entity Data Model (EDM)-Modells wird als "Code First" bezeichnet. |
| GetType() |
Ruft die Type der aktuellen Instanz ab. |
| HasDefaultSchema(String) |
Konfiguriert den Standardnamen des Datenbankschemas. Dieser Standardname des Datenbankschemas wird für Datenbankobjekte verwendet, die keinen explizit konfigurierten Schemanamen aufweisen. |
| Ignore(IEnumerable<Type>) |
Schließt die angegebenen Typen aus dem Modell aus. Dies wird verwendet, um Typen aus dem Modell zu entfernen, die während der anfänglichen Modellermittlung durch Konvention hinzugefügt wurden. |
| Ignore<T>() |
Schließt einen Typ aus dem Modell aus. Dies wird verwendet, um Typen aus dem Modell zu entfernen, die während der anfänglichen Modellermittlung durch Konvention hinzugefügt wurden. |
| Properties() |
Beginnt mit der Konfiguration einer einfachen Konvention, die für alle Eigenschaften im Modell gilt. |
| Properties<T>() |
Beginnt mit der Konfiguration einer einfachen Konvention, die für alle grundtypspezifischen Eigenschaften des angegebenen Typs im Modell gilt. |
| RegisterEntityType(Type) |
Registriert einen Entitätstyp als Teil des Modells. |
| ToString() |
DbModelBuilder wird verwendet, um CLR-Klassen einem Datenbankschema zuzuordnen. Dieser codeorientierte Ansatz zum Erstellen eines Entity Data Model (EDM)-Modells wird als "Code First" bezeichnet. |
| Types() |
Beginnt mit der Konfiguration einer einfachen Konvention, die für alle Entitäten und komplexen Typen im Modell gilt. |
| Types<T>() |
Beginnt mit der Konfiguration einer einfachen Konvention, die für alle Entitäten und komplexen Typen im Modell gilt, die von dem vom generischen Argument angegebenen Typ erben oder implementieren. Diese Methode registriert keine Typen als Teil des Modells. |