DatabaseFacade Klasse

Definition

Namespace:

Microsoft.EntityFrameworkCore.Infrastructure

Assembly:

Microsoft.EntityFrameworkCore.dll

Paket:

Microsoft.EntityFrameworkCore v8.0.0

Ermöglicht den Zugriff auf datenbankbezogene Informationen und Vorgänge für einen Kontext. Instanzen dieser Klasse werden in der Regel von Database abgerufen und sind nicht für die direkte Erstellung in Ihrem Anwendungscode konzipiert.

public class DatabaseFacade : Microsoft.EntityFrameworkCore.Infrastructure.IInfrastructure<IServiceProvider>, Microsoft.EntityFrameworkCore.Infrastructure.IResettableService, Microsoft.EntityFrameworkCore.Storage.IDatabaseFacadeDependenciesAccessor

type DatabaseFacade = class
    interface IInfrastructure<IServiceProvider>
    interface IDatabaseFacadeDependenciesAccessor
    interface IResettableService

Public Class DatabaseFacade
Implements IDatabaseFacadeDependenciesAccessor, IInfrastructure(Of IServiceProvider), IResettableService

Vererbung

Object

DatabaseFacade

Implementiert

IInfrastructure<IServiceProvider> IDatabaseFacadeDependenciesAccessor IResettableService

Konstruktoren

DatabaseFacade(DbContext)

Initialisiert eine neue Instanz der DatabaseFacade-Klasse. Instanzen dieser Klasse werden in der Regel von Database abgerufen und sind nicht für die direkte Erstellung in Ihrem Anwendungscode konzipiert.

Eigenschaften

AutoSavepointsEnabled	Gibt an, ob ein Transaktionsspeicherpunkt automatisch SaveChanges() erstellt wird, wenn er aufgerufen wird, nachdem eine Transaktion manuell mit BeginTransaction()gestartet wurde.
AutoTransactionBehavior	Ruft einen Wert ab, der angibt, ob eine Transaktion automatisch erstellt wird, wenn SaveChanges() weder "BeginTransaction" noch "UseTransaction" aufgerufen wurde, oder legt diesen fest.
AutoTransactionsEnabled	Veraltet. Ruft einen Wert ab, der angibt, ob eine Transaktion automatisch erstellt wird, wenn SaveChanges() keine der Methoden "BeginTransaction" oder "UseTransaction" aufgerufen wurde, oder legt diesen fest.
CurrentTransaction	Ruft den aktuellen IDbContextTransaction ab, der vom Kontext verwendet wird, oder NULL, wenn keine Transaktion verwendet wird.
ProviderName	Gibt den Namen des derzeit verwendeten Datenbankanbieters zurück. Der Name ist in der Regel der Name der Anbieterassembly. Es ist in der Regel einfacher, eine Zuckermethode wie zu Microsoft.EntityFrameworkCore.SqlServerDatabaseFacadeExtensions.IsSqlServer verwenden, anstatt diese Methode direkt aufzurufen.

Methoden

BeginTransaction()	Startet eine neue Transaktion.
BeginTransactionAsync(CancellationToken)	Startet asynchron eine neue Transaktion.
CanConnect()	Bestimmt, ob die Datenbank verfügbar ist und mit der eine Verbindung hergestellt werden kann.
CanConnectAsync(CancellationToken)	Bestimmt, ob die Datenbank verfügbar ist und mit der eine Verbindung hergestellt werden kann.
CommitTransaction()	Wendet die ausstehenden Vorgänge in der aktuellen Transaktion auf die Datenbank an.
CommitTransactionAsync(CancellationToken)	Wendet die ausstehenden Vorgänge in der aktuellen Transaktion auf die Datenbank an.
CreateExecutionStrategy()	Erstellt eine instance des konfigurierten IExecutionStrategy.
EnsureCreated()	Stellt sicher, dass die Datenbank für den Kontext vorhanden ist.
EnsureCreatedAsync(CancellationToken)	Stellt sicher, dass die Datenbank für den Kontext vorhanden ist.
EnsureDeleted()	Stellt sicher, dass die Datenbank für den Kontext nicht vorhanden ist. Wenn sie nicht vorhanden ist, wird keine Aktion ausgeführt. Wenn sie vorhanden ist, wird die Datenbank gelöscht. Warnung: Die gesamte Datenbank wird gelöscht, und es werden keine Anstrengungen unternommen, nur die Datenbankobjekte zu entfernen, die vom Modell für diesen Kontext verwendet werden.
EnsureDeletedAsync(CancellationToken)	Stellt asynchron sicher, dass die Datenbank für den Kontext nicht vorhanden ist. Wenn sie nicht vorhanden ist, wird keine Aktion ausgeführt. Wenn sie vorhanden ist, wird die Datenbank gelöscht. Warnung: Die gesamte Datenbank wird gelöscht, und es werden keine Anstrengungen unternommen, nur die Datenbankobjekte zu entfernen, die vom Modell für diesen Kontext verwendet werden.
RollbackTransaction()	Verwirft die ausstehenden Vorgänge in der aktuellen Transaktion.
RollbackTransactionAsync(CancellationToken)	Verwirft die ausstehenden Vorgänge in der aktuellen Transaktion.

Explizite Schnittstellenimplementierungen

IDatabaseFacadeDependenciesAccessor.Context	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 vorherige Ankündigung in jeder Version geändert oder entfernt werden. Sie sollten es nur mit äußerster Vorsicht direkt in Ihrem Code verwenden und wissen, dass dies bei der Aktualisierung auf ein neues Entity Framework Core-Release zu Anwendungsfehlern führen kann.
IDatabaseFacadeDependenciesAccessor.Dependencies	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 vorherige Ankündigung in jeder Version geändert oder entfernt werden. Sie sollten es nur mit äußerster Vorsicht direkt in Ihrem Code verwenden und wissen, dass dies bei der Aktualisierung auf ein neues Entity Framework Core-Release zu Anwendungsfehlern führen kann.
IInfrastructure<IServiceProvider>.Instance	Ruft den Bereich IServiceProvider ab, der zum Auflösen von Diensten verwendet wird. Diese Eigenschaft ist für die Verwendung durch Erweiterungsmethoden vorgesehen, die Dienste verwenden müssen, die nicht direkt in der öffentlichen API-Oberfläche verfügbar gemacht werden.
IResettableService.ResetState()	Setzt den Dienst zurück, sodass er aus dem Pool verwendet werden kann.
IResettableService.ResetStateAsync(CancellationToken)	Ermöglicht den Zugriff auf datenbankbezogene Informationen und Vorgänge für einen Kontext. Instanzen dieser Klasse werden in der Regel von Database abgerufen und sind nicht für die direkte Erstellung in Ihrem Anwendungscode konzipiert.

Erweiterungsmethoden

GetCosmosClient(DatabaseFacade)	Ruft den zugrunde liegenden CosmosClient für diesen DbContextab.
GetCosmosDatabaseId(DatabaseFacade)	Ruft den konfigurierten Datenbanknamen für diese DbContextab.
IsCosmos(DatabaseFacade)	Gibt zurück true , wenn der derzeit verwendete Datenbankanbieter der Cosmos-Anbieter ist.
GetInfrastructure<T>(IInfrastructure<T>)	Ruft den Wert aus einer Eigenschaft ab, die mit IInfrastructure<T>ausgeblendet wird. Diese Methode wird in der Regel von Datenbankanbietern (und anderen Erweiterungen) verwendet. Es wird in der Regel nicht im Anwendungscode verwendet.
IsInMemory(DatabaseFacade)	Gibt zurück true , wenn der derzeit verwendete Datenbankanbieter der In-Memory-Anbieter ist.
BeginTransaction(DatabaseFacade, IsolationLevel)	Startet eine neue Transaktion mit einem angegebenen IsolationLevel.
BeginTransactionAsync(DatabaseFacade, IsolationLevel, CancellationToken)	Startet asynchron eine neue Transaktion mit einem angegebenen IsolationLevel.
CloseConnection(DatabaseFacade)	Schließt die zugrunde liegende DbConnection.
CloseConnectionAsync(DatabaseFacade)	Schließt die zugrunde liegende DbConnection.
ExecuteSql(DatabaseFacade, FormattableString)	Führt die angegebene SQL für die Datenbank aus und gibt die Anzahl der betroffenen Zeilen zurück.
ExecuteSqlAsync(DatabaseFacade, FormattableString, CancellationToken)	Führt die angegebene SQL für die Datenbank aus und gibt die Anzahl der betroffenen Zeilen zurück.
ExecuteSqlInterpolated(DatabaseFacade, FormattableString)	Führt die angegebene SQL für die Datenbank aus und gibt die Anzahl der betroffenen Zeilen zurück.
ExecuteSqlInterpolatedAsync(DatabaseFacade, FormattableString, CancellationToken)	Führt die angegebene SQL für die Datenbank aus und gibt die Anzahl der betroffenen Zeilen zurück.
ExecuteSqlRaw(DatabaseFacade, String, IEnumerable<Object>)	Führt die angegebene SQL für die Datenbank aus und gibt die Anzahl der betroffenen Zeilen zurück.
ExecuteSqlRaw(DatabaseFacade, String, Object[])	Führt die angegebene SQL für die Datenbank aus und gibt die Anzahl der betroffenen Zeilen zurück.
ExecuteSqlRawAsync(DatabaseFacade, String, IEnumerable<Object>, CancellationToken)	Führt die angegebene SQL für die Datenbank aus und gibt die Anzahl der betroffenen Zeilen zurück.
ExecuteSqlRawAsync(DatabaseFacade, String, Object[])	Führt die angegebene SQL für die Datenbank aus und gibt die Anzahl der betroffenen Zeilen zurück.
ExecuteSqlRawAsync(DatabaseFacade, String, CancellationToken)	Führt die angegebene SQL für die Datenbank aus und gibt die Anzahl der betroffenen Zeilen zurück.
GenerateCreateScript(DatabaseFacade)	Generiert ein Skript zum Erstellen aller Tabellen für das aktuelle Modell.
GetAppliedMigrations(DatabaseFacade)	Ruft alle Migrationen ab, die auf die Zieldatenbank angewendet wurden.
GetAppliedMigrationsAsync(DatabaseFacade, CancellationToken)	Ruft asynchron alle Migrationen ab, die auf die Zieldatenbank angewendet wurden.
GetCommandTimeout(DatabaseFacade)	Gibt das Timeout (in Sekunden) für Befehle zurück, die mit diesem DbContextausgeführt werden.
GetConnectionString(DatabaseFacade)	Ruft die zugrunde liegende Verbindungszeichenfolge ab, die für diesen DbContextkonfiguriert ist.
GetDbConnection(DatabaseFacade)	Ruft den zugrunde liegenden ADO.NET DbConnection für diesen DbContextab.
GetMigrations(DatabaseFacade)	Ruft alle Migrationen ab, die in der konfigurierten Migrationsassembly definiert sind.
GetPendingMigrations(DatabaseFacade)	Ruft alle Migrationen ab, die in der Assembly definiert, aber nicht auf die Zieldatenbank angewendet wurden.
GetPendingMigrationsAsync(DatabaseFacade, CancellationToken)	Ruft asynchron alle Migrationen ab, die in der Assembly definiert, aber nicht auf die Zieldatenbank angewendet wurden.
HasPendingModelChanges(DatabaseFacade)	Gibt zurück true , wenn das Modell über ausstehende Änderungen verfügt, die angewendet werden sollen.
IsRelational(DatabaseFacade)	Gibt zurück true , wenn der derzeit verwendete Datenbankanbieter eine relationale Datenbank ist.
Migrate(DatabaseFacade)	Wendet alle ausstehenden Migrationen für den Kontext auf die Datenbank an. Erstellt die Datenbank, wenn sie noch nicht vorhanden ist.
MigrateAsync(DatabaseFacade, CancellationToken)	Wendet alle ausstehenden Migrationen für den Kontext asynchron auf die Datenbank an. Erstellt die Datenbank, wenn sie noch nicht vorhanden ist.
OpenConnection(DatabaseFacade)	Öffnet die zugrunde liegende DbConnection.
OpenConnectionAsync(DatabaseFacade, CancellationToken)	Öffnet die zugrunde liegende DbConnection.
SetCommandTimeout(DatabaseFacade, Nullable<Int32>)	Legt das Timeout (in Sekunden) fest, das für Befehle verwendet werden soll, die mit diesem DbContextausgeführt werden.
SetCommandTimeout(DatabaseFacade, TimeSpan)	Legt das Timeout fest, das für Befehle verwendet werden soll, die mit diesem DbContextausgeführt werden.
SetConnectionString(DatabaseFacade, String)	Legt den zugrunde liegenden Verbindungszeichenfolge fest, der für diesen DbContextkonfiguriert ist.
SetDbConnection(DatabaseFacade, DbConnection, Boolean)	Legt den zugrunde liegenden ADO.NET DbConnection für diesen DbContextfest.
SqlQuery<TResult>(DatabaseFacade, FormattableString)	Erstellt eine LINQ-Abfrage basierend auf einer SQL-Rohabfrage, die einen Resultset eines skalaren Typs zurückgibt, der vom Datenbankanbieter nativ unterstützt wird.
SqlQueryRaw<TResult>(DatabaseFacade, String, Object[])	Erstellt eine LINQ-Abfrage basierend auf einer SQL-Rohabfrage, die einen Resultset eines skalaren Typs zurückgibt, der vom Datenbankanbieter nativ unterstützt wird.
UseTransaction(DatabaseFacade, DbTransaction, Guid)	Legt fest, dass von DbTransaction Datenbankvorgängen für verwendet DbContextwerden soll.
UseTransaction(DatabaseFacade, DbTransaction)	Legt fest, dass von DbTransaction Datenbankvorgängen für verwendet DbContextwerden soll.
UseTransactionAsync(DatabaseFacade, DbTransaction, Guid, CancellationToken)	Legt fest, dass von DbTransaction Datenbankvorgängen für verwendet DbContextwerden soll.
UseTransactionAsync(DatabaseFacade, DbTransaction, CancellationToken)	Legt fest, dass von DbTransaction Datenbankvorgängen für verwendet DbContextwerden soll.
IsSqlite(DatabaseFacade)	Gibt zurück true , wenn der derzeit verwendete Datenbankanbieter der SQLite-Anbieter ist.
IsSqlServer(DatabaseFacade)	Gibt zurücktrue, wenn der derzeit verwendete Datenbankanbieter der SQL Server Anbieter ist.
EnlistTransaction(DatabaseFacade, Transaction)	Gibt einen vorhandenen Transaction an, der für Datenbankvorgänge verwendet werden soll.
GetEnlistedTransaction(DatabaseFacade)	Gibt die aktuell eingetragene Transaktion zurück.