ModelBuilder Klasse

Definition

Namespace:

Microsoft.EntityFrameworkCore

Assembly:

Microsoft.EntityFrameworkCore.dll

Paket:

Microsoft.EntityFrameworkCore v8.0.0

Stellt eine einfache API-Oberfläche zum Konfigurieren einer bereit IMutableModel , die die Form Ihrer Entitäten, die Beziehungen zwischen ihnen und ihre Zuordnung zur Datenbank definiert.

public class ModelBuilder : Microsoft.EntityFrameworkCore.Infrastructure.IInfrastructure<Microsoft.EntityFrameworkCore.Metadata.Builders.IConventionModelBuilder>

type ModelBuilder = class
    interface IInfrastructure<IConventionModelBuilder>

Public Class ModelBuilder
Implements IInfrastructure(Of IConventionModelBuilder)

Vererbung

Object

ModelBuilder

Implementiert

IInfrastructure<IConventionModelBuilder>

Hinweise

Sie können verwenden ModelBuilder , um ein Modell für einen Kontext zu erstellen, indem Sie ihren abgeleiteten OnModelCreating(ModelBuilder) Kontext überschreiben. Alternativ können Sie das Modell extern erstellen und auf einer DbContextOptions instance festlegen, die an den Kontextkonstruktor übergeben wird.

Weitere Informationen und Beispiele finden Sie unter Modellieren von Entitätstypen und Beziehungen in EF Core .

Konstruktoren

ModelBuilder()	Initialisiert einen neuen instance der ModelBuilder -Klasse ohne Konventionen. Warnung: Konventionen sind erforderlich, um ein richtiges Modell zu erstellen.
ModelBuilder(ConventionSet)	Initialisiert eine neue instance der -Klasse, die ModelBuilder eine Reihe von Konventionen anwendet.
ModelBuilder(ConventionSet, ModelDependencies)	Initialisiert eine neue instance der -Klasse, die ModelBuilder eine Reihe von Konventionen anwendet.
ModelBuilder(ConventionSet, ModelDependencies, ModelConfiguration)	Dies ist eine interne API, die die Entity Framework Core-Infrastruktur unterstützt und nicht den gleichen Kompatibilitätsstandards wie öffentliche APIs unterliegt. Es kann ohne Vorankündigung in einer Version geändert oder entfernt werden. Sie sollten es nur mit äußerster Vorsicht direkt im Code verwenden und wissen, dass dies beim Aktualisieren auf ein neues Entity Framework Core-Release zu Anwendungsfehlern führen kann.
ModelBuilder(IMutableModel)	Dies ist eine interne API, die die Entity Framework Core-Infrastruktur unterstützt und nicht den gleichen Kompatibilitätsstandards wie öffentliche APIs unterliegt. Es kann ohne Vorankündigung in einer Version geändert oder entfernt werden. Sie sollten es nur mit äußerster Vorsicht direkt im Code verwenden und wissen, dass dies beim Aktualisieren auf ein neues Entity Framework Core-Release zu Anwendungsfehlern führen kann.

Eigenschaften

Model

Das zu konfigurierende Modell.

Methoden

ApplyConfiguration<TEntity>(IEntityTypeConfiguration<TEntity>)	Wendet eine Konfiguration an, die in einer IEntityTypeConfiguration<TEntity> instance definiert ist.
ApplyConfigurationsFromAssembly(Assembly, Func<Type,Boolean>)	Wendet die Konfiguration von allen IEntityTypeConfiguration<TEntity> Instanzen an, die in der bereitgestellten Assembly definiert sind.
Entity(String)	Gibt ein -Objekt zurück, das zum Konfigurieren eines bestimmten Entitätstyps im Modell verwendet werden kann. Wenn ein Entitätstyp mit dem angegebenen Namen nicht bereits Teil des Modells ist, wird dem Modell ein neuer Entitätstyp hinzugefügt, der keinen entsprechenden CLR-Typ aufweist.
Entity(String, Action<EntityTypeBuilder>)	Führt die Konfiguration eines bestimmten Entitätstyps im Modell aus. Wenn ein Entitätstyp mit dem angegebenen Namen nicht bereits Teil des Modells ist, wird dem Modell ein neuer Entitätstyp hinzugefügt, der keinen entsprechenden CLR-Typ aufweist.
Entity(Type)	Gibt ein -Objekt zurück, das zum Konfigurieren eines bestimmten Entitätstyps im Modell verwendet werden kann. Wenn der Entitätstyp noch nicht Teil des Modells ist, wird er dem Modell hinzugefügt.
Entity(Type, Action<EntityTypeBuilder>)	Führt die Konfiguration eines bestimmten Entitätstyps im Modell aus. Wenn der Entitätstyp noch nicht Teil des Modells ist, wird er dem Modell hinzugefügt.
Entity<TEntity>()	Gibt ein -Objekt zurück, das zum Konfigurieren eines bestimmten Entitätstyps im Modell verwendet werden kann. Wenn der Entitätstyp noch nicht Teil des Modells ist, wird er dem Modell hinzugefügt.
Entity<TEntity>(Action<EntityTypeBuilder<TEntity>>)	Führt die Konfiguration eines bestimmten Entitätstyps im Modell aus. Wenn der Entitätstyp noch nicht Teil des Modells ist, wird er dem Modell hinzugefügt.
FinalizeModel()	Erzwingt die Nachverarbeitung für das Modell, sodass es von der Runtime verwendet werden kann. Diese Nachverarbeitung erfolgt automatisch, wenn sie verwendet OnModelCreating(ModelBuilder)wird. Mit dieser Methode kann sie explizit ausgeführt werden, wenn die automatische Ausführung nicht möglich ist.
HasAnnotation(String, Object)	Fügt eine Anmerkung zum Modell hinzu oder aktualisiert sie. Wenn eine Anmerkung mit dem in annotation angegebenen Schlüssel bereits vorhanden ist, wird ihr Wert aktualisiert.
HasChangeTrackingStrategy(ChangeTrackingStrategy)	Konfiguriert den Standard ChangeTrackingStrategy , der für dieses Modell verwendet werden soll. Diese Strategie gibt an, wie der Kontext Änderungen an Eigenschaften für eine instance eines Entitätstyps erkennt.
Ignore(String)	Schließt einen Entitätstyp mit dem angegebenen Namen aus dem Modell aus. Diese Methode wird in der Regel verwendet, um Typen aus dem Modell zu entfernen, die durch die Konvention hinzugefügt wurden.
Ignore(Type)	Schließt einen Entitätstyp mit dem angegebenen CLR-Typ aus dem Modell aus. Diese Methode wird in der Regel verwendet, um Typen aus dem Modell zu entfernen, die durch die Konvention hinzugefügt wurden.
Ignore<TEntity>()	Schließt den angegebenen Entitätstyp aus dem Modell aus. Diese Methode wird in der Regel verwendet, um Typen aus dem Modell zu entfernen, die durch die Konvention hinzugefügt wurden.
Owned(Type)	Kennzeichnet einen Entitätstyp als besitzer besitzend. Alle Verweise auf diesen Typ werden als separate eigene Typinstanzen konfiguriert.
Owned<T>()	Kennzeichnet einen Entitätstyp als besitzer besitzend. Alle Verweise auf diesen Typ werden als separate eigene Typinstanzen konfiguriert.
SharedTypeEntity(String, Type)	Gibt ein -Objekt zurück, das zum Konfigurieren eines bestimmten Entitätstyps für freigegebene Typen im Modell verwendet werden kann.
SharedTypeEntity(String, Type, Action<EntityTypeBuilder>)	Gibt ein -Objekt zurück, das zum Konfigurieren eines bestimmten Entitätstyps für freigegebene Typen im Modell verwendet werden kann.
SharedTypeEntity<TEntity>(String)	Gibt ein -Objekt zurück, das zum Konfigurieren eines bestimmten Entitätstyps für freigegebene Typen im Modell verwendet werden kann.
SharedTypeEntity<TEntity>(String, Action<EntityTypeBuilder<TEntity>>)	Gibt ein -Objekt zurück, das zum Konfigurieren eines bestimmten Entitätstyps für freigegebene Typen im Modell verwendet werden kann.
UsePropertyAccessMode(PropertyAccessMode)	Legt fest, dass für PropertyAccessMode alle Eigenschaften dieses Entitätstyps verwendet werden soll.

Explizite Schnittstellenimplementierungen

IInfrastructure<IConventionModelBuilder>.Instance

Der interne ModelBuilder , der zum Konfigurieren dieses Modells verwendet wird.

Erweiterungsmethoden

HasAutoscaleThroughput(ModelBuilder, Nullable<Int32>)	Konfiguriert das Angebot für den bereitgestellten Automatischskalierungsdurchsatz.
HasDefaultContainer(ModelBuilder, String)	Konfiguriert den Standardcontainernamen, der verwendet wird, wenn kein Name explizit für einen Entitätstyp konfiguriert ist.
HasManualThroughput(ModelBuilder, Nullable<Int32>)	Konfiguriert das Angebot für manuell bereitgestellten Durchsatz.
HasDbFunction(ModelBuilder, MethodInfo)	Konfiguriert eine Datenbankfunktion, wenn eine relationale Datenbank als Ziel verwendet wird.
HasDbFunction(ModelBuilder, MethodInfo, Action<DbFunctionBuilder>)	Konfiguriert eine Datenbankfunktion, wenn eine relationale Datenbank als Ziel verwendet wird.
HasDbFunction<TResult>(ModelBuilder, Expression<Func<TResult>>)	Konfiguriert eine Datenbankfunktion, wenn eine relationale Datenbank als Ziel verwendet wird.
HasDefaultSchema(ModelBuilder, String)	Konfiguriert das Standardschema, in dem Datenbankobjekte erstellt werden sollen, wenn kein Schema explizit konfiguriert ist.
HasSequence(ModelBuilder, String, Action<SequenceBuilder>)	Konfiguriert eine Datenbanksequenz beim Ziel einer relationalen Datenbank.
HasSequence(ModelBuilder, String, String)	Konfiguriert eine Datenbanksequenz beim Ziel einer relationalen Datenbank.
HasSequence(ModelBuilder, String, String, Action<SequenceBuilder>)	Konfiguriert eine Datenbanksequenz beim Ziel einer relationalen Datenbank.
HasSequence(ModelBuilder, Type, String, Action<SequenceBuilder>)	Konfiguriert eine Datenbanksequenz beim Ziel einer relationalen Datenbank.
HasSequence(ModelBuilder, Type, String, String)	Konfiguriert eine Datenbanksequenz beim Ziel einer relationalen Datenbank.
HasSequence(ModelBuilder, Type, String, String, Action<SequenceBuilder>)	Konfiguriert eine Datenbanksequenz beim Ziel einer relationalen Datenbank.
HasSequence<T>(ModelBuilder, String, Action<SequenceBuilder>)	Konfiguriert eine Datenbanksequenz beim Ziel einer relationalen Datenbank.
HasSequence<T>(ModelBuilder, String, String)	Konfiguriert eine Datenbanksequenz beim Ziel einer relationalen Datenbank.
HasSequence<T>(ModelBuilder, String, String, Action<SequenceBuilder>)	Konfiguriert eine Datenbanksequenz beim Ziel einer relationalen Datenbank.
UseCollation(ModelBuilder, String)	Konfiguriert die Datenbanksortierung, die von allen Spalten ohne explizite Sortierung verwendet wird.
HasDatabaseMaxSize(ModelBuilder, String)	Konfiguriert die maximale Größe für Azure SQL-Datenbank.
HasPerformanceLevel(ModelBuilder, String)	Konfiguriert die Leistungsstufe (SERVICE_OBJECTIVE) für Azure SQL-Datenbank als Zeichenfolgenliteral.
HasPerformanceLevelSql(ModelBuilder, String)	Konfiguriert die Leistungsstufe (SERVICE_OBJECTIVE) für Azure SQL-Datenbank als SQL-Ausdruck.
HasServiceTier(ModelBuilder, String)	Konfiguriert die Dienstebene (EDITION) für Azure SQL-Datenbank als Zeichenfolgenliteral.
HasServiceTierSql(ModelBuilder, String)	Konfiguriert die Dienstebene (EDITION) für Azure SQL Database als SQL-Ausdruck.
UseHiLo(ModelBuilder, String, String)	Konfiguriert das Modell so, dass ein sequenzbasiertes Hi-Lo-Muster verwendet wird, um Werte für als gekennzeichnete OnAddSchlüsseleigenschaften zu generieren, wenn SQL Server.
UseIdentityColumns(ModelBuilder, Int32, Int32)	Konfiguriert das Modell so, dass das SQL Server IDENTITY-Feature verwendet wird, um Werte für als gekennzeichnete OnAddSchlüsseleigenschaften zu generieren, wenn SQL Server. Dies ist das Standardverhalten beim Ziel SQL Server.
UseIdentityColumns(ModelBuilder, Int64, Int32)	Konfiguriert das Modell so, dass das SQL Server IDENTITY-Feature verwendet wird, um Werte für als gekennzeichnete OnAddSchlüsseleigenschaften zu generieren, wenn SQL Server. Dies ist das Standardverhalten beim Ziel SQL Server.
UseKeySequences(ModelBuilder, String, String)	Konfiguriert das Modell so, dass eine Sequenz pro Hierarchie verwendet wird, um Werte für Schlüsseleigenschaften zu generieren, die als OnAddgekennzeichnet sind, wenn SQL Server.