DbModelBuilder-Klasse

[Diese Seite bezieht sich auf Entity Framework Version 6. Die neueste Version ist als 'Entity Framework' NuGet-Paket verfügbar. Weitere Informationen zu Entity Framework finden Sie unter msdn.com/data/ef.]

DbModelBuilder wird verwendet, um einem Datenbankschema CLR-Klassen zuzuordnen. Dieser codezentrierte Ansatz zum Erstellen eines Entity Data Model (EDM) wird als "Code First" bezeichnet.

Vererbungshierarchie

System.Object
  System.Data.Entity.DbModelBuilder

Namespace:  System.Data.Entity
Assembly:  EntityFramework (in EntityFramework.dll)

Syntax

'Declaration
Public Class DbModelBuilder
'Usage
Dim instance As DbModelBuilder

public class DbModelBuilder

public ref class DbModelBuilder

type DbModelBuilder =  class end

public class DbModelBuilder

Der DbModelBuilder-Typ macht die folgenden Member verfügbar.

Konstruktoren

	Name	Beschreibung
	DbModelBuilder()	Initialisiert eine neue Instanz der DbModelBuilder-Klasse.Zum Ermitteln des ursprünglichen Modells wird der Satz der Konventionen in der letzten Version des Entity Framework verwendet, die auf dem Computer installiert ist.
	DbModelBuilder(DbModelBuilderVersion)	Initialisiert eine neue Instanz der DbModelBuilder-Klasse, die einen bestimmten Satz von Konventionen verwendet, um das ursprüngliche Modell zu ermitteln.

Oben

Eigenschaften

	Name	Beschreibung
	Configurations	Ruft das ConfigurationRegistrar für diesen DbModelBuilder ab.Die Registrierungsstelle ermöglicht das Registrieren von abgeleiteten Konfigurationen für Entitäten und komplexe Typen bei dem Generator.
	Conventions	Bietet Zugriff auf die Einstellungen des DbModelBuilder, die Konventionen behandeln.

Oben

Methoden

	Name	Beschreibung
	Build(DbConnection)	Erstellt ein DbModel auf Grundlage der Konfiguration, die mit diesem Generator ausgeführt wurde.Die Verbindung wird verwendet, um den verwendeten Datenbankanbieter zu bestimmen, da sich dies auf die Datenbankebene des generierten Modells auswirkt.
	Build(DbProviderInfo)	Erstellt ein DbModel auf Grundlage der 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 komplexen Typ im Modell und gibt ein Objekt zurück, das zum Konfigurieren des komplexen Typs verwendet werden kann.Diese Methode kann mehrmals für den gleichen Typ aufgerufen werden, um mehrere Zeilen der Konfiguration auszuführen.
	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 die gleiche Entität aufgerufen werden, um mehrere Zeilen der Konfiguration auszuführen.
	Equals	Gibt an, ob der DbModelBuilder mit dem angegebenen Objekt identisch ist. (Überschreibt Object.Equals(Object).)
	Finalize	(Von Object geerbt.)
	GetHashCode	Gibt den Hashcode für die aktuelle Instanz zurück. (Überschreibt Object.GetHashCode().)
	GetType	Ruft den Type der aktuellen Instanz ab.
	HasDefaultSchema	Konfiguriert den standardmäßigen Datenbankschemanamen.Dieser standardmäßige Datenbankschemaname wird für Datenbankobjekte verwendet, die über keinen ausdrücklich konfigurierten Schemanamen verfügen.
	Ignore(IEnumerable<Type>)	Schließt die angegebenen Typen vom Modell aus.Wird verwendet, um Typen aus dem Modell zu entfernen, die während der Ermittlung des ursprünglichen Modells konventionsgemäß hinzugefügt wurden.
	Ignore<T>()	Schließt einen Typ aus dem Modell aus.Wird verwendet, um Typen aus dem Modell zu entfernen, die während der Ermittlung des ursprünglichen Modells konventionsgemäß hinzugefügt wurden.
	MemberwiseClone	(Von Object geerbt.)
	Properties()	Startet die Konfiguration einer einfachen Konvention, die für alle Eigenschaften im Modell gilt.
	Properties<T>()	Startet die Konfiguration einer einfachen Konvention, die für alle primitiven Eigenschaften des angegebenen Typs im Modell gilt.
	RegisterEntityType	Registriert einen Entitätstyp als Teil des Modells.
	ToString	Gibt eine Zeichenfolgendarstellung des DbModelBuilder zurück. (Überschreibt Object.ToString().)
	Types()	Startet die Konfiguration einer einfachen Konvention, die für alle Entitäten und komplexen Typen im Modell gilt.
	Types<T>()	Startet die Konfiguration einer einfachen Konvention, die für alle Entitäten und komplexen Typen im Modell gilt, die von dem durch das generische Argument angegebenen Typ erben oder diesen implementieren.Diese Methode registriert Typen nicht als Teil des Modells.

Oben

Hinweise

DbModelBuilder wird i. d. R. verwendet, um ein Modell durch Überschreiben von OnModelCreating(DbModelBuilder) zu konfigurieren. Sie können DbModelBuilder auch unabhängig von DbContext verwenden, um zunächst ein DbContext-Modell und dann einen ObjectContext zu erstellen. Die empfohlene Vorgehensweise, OnModelCreating im DbContext als Workflow zu verwenden, ist jedoch intuitiver und umfasst häufige Aufgaben, z. B. das Zwischenspeichern des Modells. Typen, die das Modell bilden, werden bei DbModelBuilder registriert. Durch das Anwenden von Datenanmerkungen auf die Klassen und/oder die Verwendung der DbModelBuilder-Fluent-API kann eine optionale Konfiguration ausgeführt werden. Beim Aufruf der Build-Methode wird ein Satz von Konventionen ausgeführt, um das ursprüngliche Modell zu ermitteln. Diese Konventionen ermitteln automatisch Aspekte des Modells, z. B. Primärschlüssel, und verarbeiten außerdem alle Datenanmerkungen, die für die Klassen angegeben wurden. Schließlich wird jede Konfiguration, die mit der DbModelBuilder-API ausgeführt wurde, angewendet. Die mit der DbModelBuilder-API ausgeführte Konfiguration hat Vorrang vor Datenanmerkungen, die wiederum Vorrang vor den Standardkonventionen haben.

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Siehe auch

Verweis

System.Data.Entity-Namespace