RelationalOptionsExtension Klasse

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.

Stellt Optionen dar, die von den relationalen Datenbankanbietern verwaltet werden. Diese Optionen werden mithilfe von DbContextOptionsBuilder.

public abstract class RelationalOptionsExtension : Microsoft.EntityFrameworkCore.Infrastructure.IDbContextOptionsExtension

[System.Runtime.CompilerServices.Nullable(0)]
public abstract class RelationalOptionsExtension : Microsoft.EntityFrameworkCore.Infrastructure.IDbContextOptionsExtension

type RelationalOptionsExtension = class
    interface IDbContextOptionsExtension

[<System.Runtime.CompilerServices.Nullable(0)>]
type RelationalOptionsExtension = class
    interface IDbContextOptionsExtension

Public MustInherit Class RelationalOptionsExtension
Implements IDbContextOptionsExtension

Vererbung: Object
RelationalOptionsExtension

Attribute: NullableAttribute

Implementiert: IDbContextOptionsExtension

Hinweise

Instanzen dieser Klasse sind so konzipiert, dass sie unveränderlich sind. Um eine Option zu ändern, rufen Sie einen der Optionen "Mit... Methoden zum Abrufen einer neuen Instanz mit geänderter Option.

Weitere Informationen und Beispiele finden Sie unter Implementierung von Datenbankanbietern und Erweiterungen .

Konstruktoren

Name	Beschreibung
RelationalOptionsExtension()	Erstellt einen neuen Satz von Optionen, wobei alles auf Standardwerte festgelegt ist.
RelationalOptionsExtension(RelationalOptionsExtension)	Wird beim Implementieren der Clone() Methode von einem abgeleiteten Klassenkonstruktor aufgerufen.

Eigenschaften

Name	Beschreibung
CommandTimeout	Das Befehlstimeout oder `null` wenn keines festgelegt wurde.
Connection	The DbConnection, or `null` if a Verbindungszeichenfolge was used instead of the full connection object.
ConnectionString	Die Verbindungszeichenfolge oder `null` wenn anstelle eines Verbindungszeichenfolge ein DbConnection Connection string verwendet wurde.
ExecutionStrategyFactory	Eine Factory zum Erstellen der Standardeinstellung IExecutionStrategyoder `null` wenn keine konfiguriert wurde.
Info	Informationen/Metadaten zur Erweiterung.
IsConnectionOwned	`true` wenn der Connection Kontext im Besitz ist und entsprechend verworfen werden sollte.
LogFragment	Erstellt ein Nachrichtenfragment für die Protokollierung, das normalerweise Informationen zu nützlichen nicht standardmäßigen Optionen enthält, die konfiguriert wurden.
MaxBatchSize	Die maximale Anzahl von Anweisungen, die in Befehlen enthalten sein werden, die während SaveChanges() oder `null` wenn keines festgelegt wurde.
MigrationsAssembly	Der Name der Assembly, die Migrationen enthält oder `null` wenn keines festgelegt wurde.
MigrationsAssemblyObject	Die Assembly, die Migrationen enthält oder `null` wenn keines festgelegt wurde.
MigrationsHistoryTableName	Der Tabellenname, der für die Migrationsverlaufstabelle verwendet werden soll, oder `null` wenn keines festgelegt wurde.
MigrationsHistoryTableSchema	Das Schema, das für die Migrationsverlaufstabelle verwendet werden soll oder `null` wenn keines festgelegt wurde.
MinBatchSize	Die Mindestanzahl von Anweisungen, die für einen Befehl mit mehreren Anweisungen erforderlich sind, der während SaveChanges() oder `null` wenn keine festgelegt wurde, an die Datenbank gesendet wird.
ParameterizedCollectionMode	Konfigurierter Übersetzungsmodus für parametrisierte Sammlungen.
ParameterizedCollectionTranslationMode	Konfigurierter Übersetzungsmodus für parametrisierte Sammlungen.
QuerySplittingBehavior	Wird QuerySplittingBehavior beim Laden verwandter Auflistungen in einer Abfrage verwendet.
UseRelationalNulls	Gibt an, ob beim Vergleichen von Nullwerten relationale Datenbanksemantik verwendet werden soll. Standardmäßig verwendet Entity Framework C#-Semantik für Nullwerte und generiert SQL, um Unterschiede bei der Behandlung von Nullen zu kompensieren.

Methoden

Name	Beschreibung
ApplyServices(IServiceCollection)	Fügt die dienste hinzu, die erforderlich sind, um die ausgewählten Optionen funktionieren zu lassen. Dies wird verwendet, wenn kein externer IServiceProvider Dienst vorhanden ist und EF einen eigenen Dienstanbieter intern verwaltet. Auf diese Weise können Datenbankanbieter (und andere Erweiterungen) ihre erforderlichen Dienste registrieren, wenn EF einen Dienstanbieter erstellt.
Clone()	Überschreiben Sie diese Methode in einer abgeleiteten Klasse, um sicherzustellen, dass jeder erstellte Klon auch von dieser Klasse ist.
Extract(IDbContextOptions)	Sucht nach einer vorhandenen RelationalOptionsExtension Registrierung für die angegebenen Optionen oder löst aus, wenn keine registriert wurde. Dies wird in der Regel verwendet, um eine relationale Konfiguration zu finden, wenn bekannt ist, dass ein relationaler Anbieter verwendet wird.
GetServiceProviderHashCode()	Gibt einen Hashcode zurück, der aus allen Optionen erstellt wurde, die dazu führen würden, dass ein neuer IServiceProvider Code benötigt wird. Die meisten Erweiterungen verfügen nicht über solche Optionen und sollten null zurückgeben.
Validate(IDbContextOptions)	Bietet der Erweiterung die Möglichkeit, zu überprüfen, ob alle Optionen in der Erweiterung gültig sind. Die meisten Erweiterungen verfügen nicht über ungültige Kombinationen, daher ist dies ein no-op. Wenn Optionen ungültig sind, sollte eine Ausnahme ausgelöst werden.
WithCommandTimeout(Nullable<Int32>)	Erstellt eine neue Instanz mit allen Optionen, die mit dieser Instanz identisch sind, aber mit der angegebenen Option geändert wurde. Es ist ungewöhnlich, diese Methode direkt aufzurufen. Verwenden Sie stattdessen DbContextOptionsBuilder.
WithConnection(DbConnection, Boolean)	Erstellt eine neue Instanz mit allen Optionen, die mit dieser Instanz identisch sind, aber mit der angegebenen Option geändert wurde. Es ist ungewöhnlich, diese Methode direkt aufzurufen. Verwenden Sie stattdessen DbContextOptionsBuilder.
WithConnection(DbConnection)	Erstellt eine neue Instanz mit allen Optionen, die mit dieser Instanz identisch sind, aber mit der angegebenen Option geändert wurde. Es ist ungewöhnlich, diese Methode direkt aufzurufen. Verwenden Sie stattdessen DbContextOptionsBuilder.
WithConnectionString(String)	Erstellt eine neue Instanz mit allen Optionen, die mit dieser Instanz identisch sind, aber mit der angegebenen Option geändert wurde. Es ist ungewöhnlich, diese Methode direkt aufzurufen. Verwenden Sie stattdessen DbContextOptionsBuilder.
WithDefaultWarningConfiguration(CoreOptionsExtension)	Fügt Standard WarningBehavior für relationale Ereignisse hinzu.
WithExecutionStrategyFactory(Func<ExecutionStrategyDependencies,IExecutionStrategy>)	Erstellt eine neue Instanz mit allen Optionen, die mit dieser Instanz identisch sind, aber mit der angegebenen Option geändert wurde. Es ist ungewöhnlich, diese Methode direkt aufzurufen. Verwenden Sie stattdessen DbContextOptionsBuilder.
WithMaxBatchSize(Nullable<Int32>)	Erstellt eine neue Instanz mit allen Optionen, die mit dieser Instanz identisch sind, aber mit der angegebenen Option geändert wurde. Es ist ungewöhnlich, diese Methode direkt aufzurufen. Verwenden Sie stattdessen DbContextOptionsBuilder.
WithMigrationsAssembly(Assembly)	Erstellt eine neue Instanz mit allen Optionen, die mit dieser Instanz identisch sind, aber mit der angegebenen Option geändert wurde. Es ist ungewöhnlich, diese Methode direkt aufzurufen. Verwenden Sie stattdessen DbContextOptionsBuilder.
WithMigrationsAssembly(String)	Erstellt eine neue Instanz mit allen Optionen, die mit dieser Instanz identisch sind, aber mit der angegebenen Option geändert wurde. Es ist ungewöhnlich, diese Methode direkt aufzurufen. Verwenden Sie stattdessen DbContextOptionsBuilder.
WithMigrationsHistoryTableName(String)	Erstellt eine neue Instanz mit allen Optionen, die mit dieser Instanz identisch sind, aber mit der angegebenen Option geändert wurde. Es ist ungewöhnlich, diese Methode direkt aufzurufen. Verwenden Sie stattdessen DbContextOptionsBuilder.
WithMigrationsHistoryTableSchema(String)	Erstellt eine neue Instanz mit allen Optionen, die mit dieser Instanz identisch sind, aber mit der angegebenen Option geändert wurde. Es ist ungewöhnlich, diese Methode direkt aufzurufen. Verwenden Sie stattdessen DbContextOptionsBuilder.
WithMinBatchSize(Nullable<Int32>)	Erstellt eine neue Instanz mit allen Optionen, die mit dieser Instanz identisch sind, aber mit der angegebenen Option geändert wurde. Es ist ungewöhnlich, diese Methode direkt aufzurufen. Verwenden Sie stattdessen DbContextOptionsBuilder.
WithParameterizedCollectionTranslationMode(ParameterizedCollectionTranslationMode)	Erstellt eine neue Instanz mit allen Optionen, die mit dieser Instanz identisch sind, aber mit der angegebenen Option geändert wurde. Es ist ungewöhnlich, diese Methode direkt aufzurufen. Verwenden Sie stattdessen DbContextOptionsBuilder.
WithUseParameterizedCollectionMode(ParameterTranslationMode)	Erstellt eine neue Instanz mit allen Optionen, die mit dieser Instanz identisch sind, aber mit der angegebenen Option geändert wurde. Es ist ungewöhnlich, diese Methode direkt aufzurufen. Verwenden Sie stattdessen DbContextOptionsBuilder.
WithUseQuerySplittingBehavior(QuerySplittingBehavior)	Erstellt eine neue Instanz mit allen Optionen, die mit dieser Instanz identisch sind, aber mit der angegebenen Option geändert wurde. Es ist ungewöhnlich, diese Methode direkt aufzurufen. Verwenden Sie stattdessen DbContextOptionsBuilder.
WithUseRelationalNulls(Boolean)	Erstellt eine neue Instanz mit allen Optionen, die mit dieser Instanz identisch sind, aber mit der angegebenen Option geändert wurde. Es ist ungewöhnlich, diese Methode direkt aufzurufen. Verwenden Sie stattdessen DbContextOptionsBuilder.

Gilt für:

Feedback

War diese Seite hilfreich?