ModelBuilder Klasse

Definition

Namespace:

Microsoft.EntityFrameworkCore

Assembly:

Microsoft.EntityFrameworkCore.dll

Paket:

Microsoft.EntityFrameworkCore v10.0.0

Quelle:

ModelBuilder.cs

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

[System.Runtime.CompilerServices.Nullable(0)]
public class ModelBuilder : Microsoft.EntityFrameworkCore.Infrastructure.IInfrastructure<Microsoft.EntityFrameworkCore.Metadata.Builders.IConventionModelBuilder>

[<System.Runtime.CompilerServices.Nullable(0)>]
type ModelBuilder = class
    interface IInfrastructure<IConventionModelBuilder>

Public Class ModelBuilder
Implements IInfrastructure(Of IConventionModelBuilder)

Vererbung

Object

ModelBuilder

Attribute

NullableAttribute

Implementiert

IInfrastructure<IConventionModelBuilder>

Hinweise

Sie können ModelBuilder ein Modell für einen Kontext erstellen, indem Sie den abgeleiteten Kontext außer Kraft setzen OnModelCreating(ModelBuilder) . Alternativ können Sie das Modell extern erstellen und für eine DbContextOptions Instanz festlegen, die an den Kontextkonstruktor übergeben wird.

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

Konstruktoren

Name	Beschreibung
ModelBuilder()	Initialisiert eine neue Instanz der ModelBuilder Klasse ohne Konventionen. Warnung: Konventionen sind erforderlich, um ein richtiges Modell zu erstellen.
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. Sie kann ohne Vorherige Ankündigung geändert oder entfernt werden. Sie sollten sie nur direkt in Ihrem Code mit äußerster Vorsicht verwenden und wissen, dass dies zu Anwendungsfehlern bei der Aktualisierung auf eine neue Entity Framework Core-Version führen kann.
ModelBuilder(ConventionSet, ModelDependencies)	Initialisiert eine neue Instanz der ModelBuilder Klasse, die eine Reihe von Konventionen anwendet.
ModelBuilder(ConventionSet)	Initialisiert eine neue Instanz der ModelBuilder Klasse, die eine Reihe von Konventionen anwendet.
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. Sie kann ohne Vorherige Ankündigung geändert oder entfernt werden. Sie sollten sie nur direkt in Ihrem Code mit äußerster Vorsicht verwenden und wissen, dass dies zu Anwendungsfehlern bei der Aktualisierung auf eine neue Entity Framework Core-Version führen kann.

Eigenschaften

Name	Beschreibung
Model	Das zu konfigurierende Modell.

Methoden

Name	Beschreibung
ApplyConfiguration<TEntity>(IEntityTypeConfiguration<TEntity>)	Wendet die Konfiguration an, die in einer IEntityTypeConfiguration<TEntity> Instanz 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, Action<EntityTypeBuilder>)	Führt die Konfiguration eines bestimmten Entitätstyps im Modell aus. Wenn ein Entitätstyp mit dem angegebenen Namen noch nicht Teil des Modells ist, wird dem Modell ein neuer Entitätstyp hinzugefügt, der keinen entsprechenden CLR-Typ aufweist.
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 noch nicht Teil des Modells ist, wird dem Modell ein neuer Entitätstyp hinzugefügt, der keinen entsprechenden CLR-Typ aufweist.
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(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<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 Nachbearbeitung auf dem Modell, sodass sie für die Verwendung durch die Laufzeit bereit ist. Diese Nachbearbeitung erfolgt automatisch bei Der Verwendung OnModelCreating(ModelBuilder). Diese Methode ermöglicht die Ausführung explizit in Fällen, in denen die automatische Ausführung nicht möglich ist.
HasAnnotation(String, Object)	Fügt eine Anmerkung für das Modell hinzu oder aktualisiert sie. Wenn eine Anmerkung mit dem angegebenen annotation Schlüssel bereits vorhanden ist, wird der Wert aktualisiert.
HasChangeTrackingStrategy(ChangeTrackingStrategy)	Konfiguriert die Standardeinstellung ChangeTrackingStrategy , die für dieses Modell verwendet werden soll. Diese Strategie gibt an, wie der Kontext Änderungen an Eigenschaften für eine Instanz eines Entitätstyps erkennt.
HasEmbeddedDiscriminatorName(String)	Legt den Namen fest, der für Diskriminatoreigenschaften verwendet werden soll, die in JSON-Dokumenten eingebettet sind. Der Standardwert ist "$type".
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, das gemäß der Konvention hinzugefügt wurde.
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, das gemäß der Konvention hinzugefügt wurde.
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, das gemäß der Konvention hinzugefügt wurde.
Owned(Type)	Kennzeichnet einen Entitätstyp im Besitz. Alle Verweise auf diesen Typ werden als separate eigene Typinstanzen konfiguriert.
Owned<T>()	Kennzeichnet einen Entitätstyp im Besitz. Alle Verweise auf diesen Typ werden als separate eigene Typinstanzen konfiguriert.
SharedTypeEntity(String, Type, Action<EntityTypeBuilder>)	Gibt ein Objekt zurück, das verwendet werden kann, um einen bestimmten Entitätstyp des freigegebenen Typs im Modell zu konfigurieren.
SharedTypeEntity(String, Type)	Gibt ein Objekt zurück, das verwendet werden kann, um einen bestimmten Entitätstyp des freigegebenen Typs im Modell zu konfigurieren.
SharedTypeEntity<TEntity>(String, Action<EntityTypeBuilder<TEntity>>)	Gibt ein Objekt zurück, das verwendet werden kann, um einen bestimmten Entitätstyp des freigegebenen Typs im Modell zu konfigurieren.
SharedTypeEntity<TEntity>(String)	Gibt ein Objekt zurück, das verwendet werden kann, um einen bestimmten Entitätstyp des freigegebenen Typs im Modell zu konfigurieren.
UsePropertyAccessMode(PropertyAccessMode)	Legt die Eigenschaft fest, die PropertyAccessMode für alle Eigenschaften dieses Entitätstyps verwendet werden soll.

Explizite Schnittstellenimplementierungen

Name	Beschreibung
IInfrastructure<IConventionModelBuilder>.Instance	Das interne ModelBuilder Objekt, das zum Konfigurieren dieses Modells verwendet wird.

Erweiterungsmethoden

Name	Beschreibung
HasAutoscaleThroughput(ModelBuilder, Nullable<Int32>)	Konfiguriert das angebot für den automatischen Durchsatz bereitgestellten Durchsatz.
HasDatabaseMaxSize(ModelBuilder, String)	Konfiguriert die maximale Größe für Azure SQL-Datenbank.
HasDbFunction(ModelBuilder, MethodInfo, Action<DbFunctionBuilder>)	Konfiguriert eine Datenbankfunktion bei der Ausrichtung auf eine relationale Datenbank.
HasDbFunction(ModelBuilder, MethodInfo)	Konfiguriert eine Datenbankfunktion bei der Ausrichtung auf eine relationale Datenbank.
HasDbFunction<TResult>(ModelBuilder, Expression<Func<TResult>>)	Konfiguriert eine Datenbankfunktion bei der Ausrichtung auf eine relationale Datenbank.
HasDefaultContainer(ModelBuilder, String)	Konfiguriert den Standardcontainernamen, der verwendet wird, wenn kein Name explizit für einen Entitätstyp konfiguriert ist.
HasDefaultFullTextLanguage(ModelBuilder, String)	Konfiguriert eine Standardsprache für die Volltextsuche im Datenbankbereich.
HasDefaultSchema(ModelBuilder, String)	Konfiguriert das Standardschema, in dem Datenbankobjekte erstellt werden sollen, wenn kein Schema explizit konfiguriert ist.
HasDiscriminatorInJsonIds(ModelBuilder, Nullable<Boolean>)	Enthält den Diskriminatorwert des Entitätstyps im JSON-Wert "id". Dies war das Standardverhalten vor EF Core 9.
HasManualThroughput(ModelBuilder, Nullable<Int32>)	Konfiguriert das angebot für den manuell bereitgestellten Durchsatz.
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.
HasRootDiscriminatorInJsonId(ModelBuilder, Nullable<Boolean>)	Enthält den Diskriminatorwert des Stammentitätstyps im JSON-Wert "id". Auf diese Weise können Typen mit demselben Primärschlüssel im selben Container gespeichert werden, während "ReadItem" weiterhin für Nachschlagevorgänge eines unbekannten Typs verwendet werden kann.
HasSequence(ModelBuilder, String, Action<SequenceBuilder>)	Konfiguriert eine Datenbanksequenz bei der Ausrichtung auf eine relationale Datenbank.
HasSequence(ModelBuilder, String, String, Action<SequenceBuilder>)	Konfiguriert eine Datenbanksequenz bei der Ausrichtung auf eine relationale Datenbank.
HasSequence(ModelBuilder, String, String)	Konfiguriert eine Datenbanksequenz bei der Ausrichtung auf eine relationale Datenbank.
HasSequence(ModelBuilder, Type, String, Action<SequenceBuilder>)	Konfiguriert eine Datenbanksequenz bei der Ausrichtung auf eine relationale Datenbank.
HasSequence(ModelBuilder, Type, String, String, Action<SequenceBuilder>)	Konfiguriert eine Datenbanksequenz bei der Ausrichtung auf eine relationale Datenbank.
HasSequence(ModelBuilder, Type, String, String)	Konfiguriert eine Datenbanksequenz bei der Ausrichtung auf eine relationale Datenbank.
HasSequence<T>(ModelBuilder, String, Action<SequenceBuilder>)	Konfiguriert eine Datenbanksequenz bei der Ausrichtung auf eine relationale Datenbank.
HasSequence<T>(ModelBuilder, String, String, Action<SequenceBuilder>)	Konfiguriert eine Datenbanksequenz bei der Ausrichtung auf eine relationale Datenbank.
HasSequence<T>(ModelBuilder, String, String)	Konfiguriert eine Datenbanksequenz bei der Ausrichtung auf eine relationale Datenbank.
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-Datenbank als SQL-Ausdruck.
HasShadowIds(ModelBuilder, Nullable<Boolean>)	Erzwingt das Erstellen eines Modells, um immer eine "__id"-Schatteneigenschaft zu erstellen, die der JSON-ID zugeordnet ist. Dies war das Standardverhalten vor EF Core 9.0.
UseCollation(ModelBuilder, String)	Konfiguriert die Datenbanksortierung, die von allen Spalten ohne explizite Sortierung verwendet wird.
UseHiLo(ModelBuilder, String, String)	Konfiguriert das Modell so, dass ein sequenzbasiertes hi-lo Muster verwendet wird, um Werte für wichtige Eigenschaften zu generieren, die als OnAdd" als " gekennzeichnet" gekennzeichnet sind, wenn auf SQL Server ausgerichtet ist.
UseIdentityColumns(ModelBuilder, Int32, Int32)	Konfiguriert das Modell so, dass das SQL Server IDENTITY-Feature verwendet wird, um Werte für schlüsseleigenschaften zu generieren, die als OnAddgekennzeichnet sind, wenn auf SQL Server ausgerichtet ist. Dies ist das Standardverhalten bei der Ausrichtung auf SQL Server.
UseIdentityColumns(ModelBuilder, Int64, Int32)	Konfiguriert das Modell so, dass das SQL Server IDENTITY-Feature verwendet wird, um Werte für schlüsseleigenschaften zu generieren, die als OnAddgekennzeichnet sind, wenn auf SQL Server ausgerichtet ist. Dies ist das Standardverhalten bei der Ausrichtung auf 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 OnAdd" als " gekennzeichnet" gekennzeichnet sind, wenn die Zielbestimmung SQL Server.
UseNamedDefaultConstraints(ModelBuilder, Boolean)	Konfiguriert das Modell so, dass benannte Standardeinschränkungen verwendet werden.