Язык

DatabaseFacade Класс

Определение

Предоставляет доступ к связанным сведениям и операциям базы данных для контекста. Экземпляры этого класса обычно получаются и Database не предназначены для непосредственного создания в коде приложения.

public class DatabaseFacade : Microsoft.EntityFrameworkCore.Infrastructure.IInfrastructure<IServiceProvider>
[System.Runtime.CompilerServices.Nullable(0)]
public class DatabaseFacade : Microsoft.EntityFrameworkCore.Infrastructure.IInfrastructure<IServiceProvider>, Microsoft.EntityFrameworkCore.Infrastructure.IResettableService, Microsoft.EntityFrameworkCore.Storage.IDatabaseFacadeDependenciesAccessor
public class DatabaseFacade : Microsoft.EntityFrameworkCore.Infrastructure.IInfrastructure<IServiceProvider>, Microsoft.EntityFrameworkCore.Internal.IDatabaseFacadeDependenciesAccessor
public class DatabaseFacade : Microsoft.EntityFrameworkCore.Infrastructure.IInfrastructure<IServiceProvider>, Microsoft.EntityFrameworkCore.Storage.IDatabaseFacadeDependenciesAccessor
public class DatabaseFacade : Microsoft.EntityFrameworkCore.Infrastructure.IInfrastructure<IServiceProvider>, Microsoft.EntityFrameworkCore.Infrastructure.IResettableService, Microsoft.EntityFrameworkCore.Storage.IDatabaseFacadeDependenciesAccessor
type DatabaseFacade = class
    interface IInfrastructure<IServiceProvider>
[<System.Runtime.CompilerServices.Nullable(0)>]
type DatabaseFacade = class
    interface IInfrastructure<IServiceProvider>
    interface IDatabaseFacadeDependenciesAccessor
    interface IResettableService
type DatabaseFacade = class
    interface IInfrastructure<IServiceProvider>
    interface IDatabaseFacadeDependenciesAccessor
type DatabaseFacade = class
    interface IInfrastructure<IServiceProvider>
    interface IDatabaseFacadeDependenciesAccessor
    interface IResettableService
Public Class DatabaseFacade
Implements IInfrastructure(Of IServiceProvider)
Public Class DatabaseFacade
Implements IDatabaseFacadeDependenciesAccessor, IInfrastructure(Of IServiceProvider), IResettableService
Public Class DatabaseFacade
Implements IDatabaseFacadeDependenciesAccessor, IInfrastructure(Of IServiceProvider)
Наследование
DatabaseFacade
Атрибуты
Реализации
IInfrastructure<IServiceProvider> IResettableService IDatabaseFacadeDependenciesAccessor Microsoft.EntityFrameworkCore.Internal.IDatabaseFacadeDependenciesAccessor

Конструкторы

Имя. Описание
DatabaseFacade(DbContext)

Инициализирует новый экземпляр класса DatabaseFacade. Экземпляры этого класса обычно получаются и Database не предназначены для непосредственного создания в коде приложения.

Свойства

Имя. Описание
AutoSavepointsEnabled

Будет ли автоматически создана точка сохранения транзакций, SaveChanges() если она вызывается после того, как транзакция была запущена BeginTransaction()вручную.

AutoTransactionBehavior

Возвращает или задает значение, указывающее, будет ли транзакция создана автоматически SaveChanges() , если ни BeginTransaction, ни UseTransaction не был вызван.

AutoTransactionsEnabled
Устаревшие.
Устаревшие.

Возвращает или задает значение, указывающее, будет ли транзакция создана автоматически, SaveChanges() если ни один из методов BeginTransaction или UseTransaction не был вызван.

CurrentTransaction

Возвращает текущий объект IDbContextTransaction , используемый контекстом, или значение NULL, если транзакция не используется.

ProviderName

Возвращает имя используемого поставщика базы данных. Имя обычно является именем сборки поставщика. Обычно проще использовать метод сахара, Microsoft.EntityFrameworkCore.SqlServerDatabaseFacadeExtensions.IsSqlServer например вместо вызова этого метода напрямую.

Методы

Имя. Описание
BeginTransaction()

Запускает новую транзакцию.

BeginTransactionAsync(CancellationToken)

Асинхронно запускает новую транзакцию.

CanConnect()

Определяет, доступна ли база данных и к ней можно подключиться.

CanConnectAsync(CancellationToken)

Определяет, доступна ли база данных и к ней можно подключиться.

CommitTransaction()

Применяет невыполненные операции в текущей транзакции к базе данных.

CommitTransactionAsync(CancellationToken)

Применяет невыполненные операции в текущей транзакции к базе данных.

CreateExecutionStrategy()

Создает экземпляр настроенного IExecutionStrategyобъекта.

EnsureCreated()

Гарантирует, что база данных для контекста существует.

EnsureCreatedAsync(CancellationToken)

Гарантирует, что база данных для контекста существует.

EnsureDeleted()

Гарантирует, что база данных для контекста не существует. Если он не существует, никаких действий не выполняется. Если она существует, база данных удаляется.

Предупреждение. Удаляется вся база данных, и никаких усилий по удалению только объектов базы данных, используемых моделью для этого контекста.

EnsureDeletedAsync(CancellationToken)

Асинхронно гарантирует, что база данных для контекста не существует. Если он не существует, никаких действий не выполняется. Если она существует, база данных удаляется.

Предупреждение. Удаляется вся база данных, и никаких усилий по удалению только объектов базы данных, используемых моделью для этого контекста.

RollbackTransaction()

Отменяет невыполненные операции в текущей транзакции.

RollbackTransactionAsync(CancellationToken)

Отменяет невыполненные операции в текущей транзакции.

Явные реализации интерфейса

Имя. Описание
IDatabaseFacadeDependenciesAccessor.Context

Это внутренний API, который поддерживает инфраструктуру Entity Framework Core и не соответствует тем же стандартам совместимости, что и общедоступные API. Его можно изменить или удалить без уведомления в любом выпуске. Его следует использовать непосредственно в коде с крайней осторожностью и зная, что это может привести к сбоям приложений при обновлении до нового выпуска Entity Framework Core.

IDatabaseFacadeDependenciesAccessor.Dependencies

Это внутренний API, который поддерживает инфраструктуру Entity Framework Core и не соответствует тем же стандартам совместимости, что и общедоступные API. Его можно изменить или удалить без уведомления в любом выпуске. Его следует использовать непосредственно в коде с крайней осторожностью и зная, что это может привести к сбоям приложений при обновлении до нового выпуска Entity Framework Core.

IInfrastructure<IServiceProvider>.Instance

Возвращает область IServiceProvider действия, используемую для разрешения служб.

Это свойство предназначено для использования методами расширения, которые должны использовать службы, не предоставляемые непосредственно в общедоступной области API.

IResettableService.ResetState()

Сбрасывает службу, чтобы ее можно было использовать из пула.

IResettableService.ResetStateAsync(CancellationToken)

Предоставляет доступ к связанным сведениям и операциям базы данных для контекста. Экземпляры этого класса обычно получаются и Database не предназначены для непосредственного создания в коде приложения.

Методы расширения

Имя. Описание
AppendSessionToken(DatabaseFacade, String)

Добавляет составной маркер сеанса для контейнера по умолчанию для этого DbContext.

AppendSessionTokens(DatabaseFacade, IReadOnlyDictionary<String,String>)

Добавляет маркер составных сеансов для каждого контейнера для этого DbContext с маркерами, указанными в sessionTokens.

BeginTransaction(DatabaseFacade, IsolationLevel)

Запускает новую транзакцию с заданным IsolationLevel.

BeginTransactionAsync(DatabaseFacade, IsolationLevel, CancellationToken)

Асинхронно запускает новую транзакцию с заданным IsolationLevel.

CloseConnection(DatabaseFacade)

Закрывает базовый DbConnectionобъект.

CloseConnectionAsync(DatabaseFacade)

Закрывает базовый DbConnectionобъект.

EnlistTransaction(DatabaseFacade, Transaction)

Указывает существующую Transaction , используемую для операций с базами данных.

ExecuteSql(DatabaseFacade, FormattableString)

Выполняет заданный SQL для базы данных и возвращает количество затронутых строк.

ExecuteSqlAsync(DatabaseFacade, FormattableString, CancellationToken)

Выполняет заданный SQL для базы данных и возвращает количество затронутых строк.

ExecuteSqlCommand(DatabaseFacade, FormattableString)
Устаревшие.

Выполняет заданный SQL для базы данных и возвращает количество затронутых строк.

Обратите внимание, что этот метод не запускает транзакцию. Чтобы использовать этот метод с транзакцией, сначала вызовите BeginTransaction(DatabaseFacade, IsolationLevel) или UseTransaction(DatabaseFacade, DbTransaction).

Обратите внимание, что текущий ExecutionStrategy метод не используется этим методом, так как SQL не может быть идемпотентным и не выполняется в транзакции. Метод ExecutionStrategy можно использовать явным образом, не забудьте также использовать транзакцию, если SQL не является идемпотентным.

Как и в случае с любым API, принимающего SQL, важно параметризовать любые входные данные пользователя для защиты от атаки внедрения SQL. Можно включить держатели параметров в строку запроса SQL, а затем указать значения параметров в качестве дополнительных аргументов. Все указанные значения параметров автоматически преобразуются в DbParameter . context.Database.ExecuteSqlCommand($"SELECT * FROM [dbo].[SearchBlogs]({userSuppliedSearchTerm})")

ExecuteSqlCommand(DatabaseFacade, RawSqlString, IEnumerable<Object>)
Устаревшие.

Выполняет заданный SQL для базы данных и возвращает количество затронутых строк.

Обратите внимание, что этот метод не запускает транзакцию. Чтобы использовать этот метод с транзакцией, сначала вызовите BeginTransaction(DatabaseFacade, IsolationLevel) или UseTransaction(DatabaseFacade, DbTransaction).

Обратите внимание, что текущий ExecutionStrategy метод не используется этим методом, так как SQL не может быть идемпотентным и не выполняется в транзакции. Метод ExecutionStrategy можно использовать явным образом, не забудьте также использовать транзакцию, если SQL не является идемпотентным.

Как и в случае с любым API, принимающего SQL, важно параметризовать любые входные данные пользователя для защиты от атаки внедрения SQL. Можно включить держатели параметров в строку запроса SQL, а затем указать значения параметров в качестве дополнительных аргументов. Все указанные значения параметров автоматически преобразуются в DbParameter. Вы также можете использовать ExecuteSqlInterpolated для использования интерполированного синтаксиса строки для создания параметров.

ExecuteSqlCommand(DatabaseFacade, RawSqlString, Object[])
Устаревшие.

Выполняет заданный SQL для базы данных и возвращает количество затронутых строк.

Обратите внимание, что этот метод не запускает транзакцию. Чтобы использовать этот метод с транзакцией, сначала вызовите BeginTransaction(DatabaseFacade, IsolationLevel) или UseTransaction(DatabaseFacade, DbTransaction).

Обратите внимание, что текущий ExecutionStrategy метод не используется этим методом, так как SQL не может быть идемпотентным и не выполняется в транзакции. Метод ExecutionStrategy можно использовать явным образом, не забудьте также использовать транзакцию, если SQL не является идемпотентным.

Как и в случае с любым API, принимающего SQL, важно параметризовать любые входные данные пользователя для защиты от атаки внедрения SQL. Можно включить держатели параметров в строку запроса SQL, а затем указать значения параметров в качестве дополнительных аргументов. Все указанные значения параметров автоматически преобразуются в DbParameter . context.Database.ExecuteSqlCommand("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm) Вы также можете использовать ExecuteSqlInterpolated для использования интерполированного синтаксиса строки для создания параметров.

ExecuteSqlCommand(DatabaseFacade, String, Object[])

Предоставляет доступ к связанным сведениям и операциям базы данных для контекста. Экземпляры этого класса обычно получаются и Database не предназначены для непосредственного создания в коде приложения.

ExecuteSqlCommandAsync(DatabaseFacade, FormattableString, CancellationToken)
Устаревшие.

Выполняет заданный SQL для базы данных и возвращает количество затронутых строк.

Обратите внимание, что этот метод не запускает транзакцию. Чтобы использовать этот метод с транзакцией, сначала вызовите BeginTransaction(DatabaseFacade, IsolationLevel) или UseTransaction(DatabaseFacade, DbTransaction).

Обратите внимание, что текущий ExecutionStrategy метод не используется этим методом, так как SQL не может быть идемпотентным и не выполняется в транзакции. Метод ExecutionStrategy можно использовать явным образом, не забудьте также использовать транзакцию, если SQL не является идемпотентным.

Как и в случае с любым API, принимающего SQL, важно параметризовать любые входные данные пользователя для защиты от атаки внедрения SQL. Можно включить держатели параметров в строку запроса SQL, а затем указать значения параметров в качестве дополнительных аргументов. Все указанные значения параметров автоматически преобразуются в DbParameter . context.Database.ExecuteSqlCommandAsync($"SELECT * FROM [dbo].[SearchBlogs]({userSuppliedSearchTerm})")

ExecuteSqlCommandAsync(DatabaseFacade, RawSqlString, CancellationToken)
Устаревшие.

Выполняет заданный SQL для базы данных и возвращает количество затронутых строк.

Обратите внимание, что этот метод не запускает транзакцию. Чтобы использовать этот метод с транзакцией, сначала вызовите BeginTransaction(DatabaseFacade, IsolationLevel) или UseTransaction(DatabaseFacade, DbTransaction).

Обратите внимание, что текущий ExecutionStrategy метод не используется этим методом, так как SQL не может быть идемпотентным и не выполняется в транзакции. Метод ExecutionStrategy можно использовать явным образом, не забудьте также использовать транзакцию, если SQL не является идемпотентным.

Как и в случае с любым API, принимающего SQL, важно параметризовать любые входные данные пользователя для защиты от атаки внедрения SQL. Можно включить держатели параметров в строку запроса SQL, а затем указать значения параметров в качестве дополнительных аргументов. Все указанные значения параметров автоматически преобразуются в DbParameter . context.Database.ExecuteSqlCommandAsync("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm)

ExecuteSqlCommandAsync(DatabaseFacade, RawSqlString, IEnumerable<Object>, CancellationToken)
Устаревшие.

Выполняет заданный SQL для базы данных и возвращает количество затронутых строк.

Обратите внимание, что этот метод не запускает транзакцию. Чтобы использовать этот метод с транзакцией, сначала вызовите BeginTransaction(DatabaseFacade, IsolationLevel) или UseTransaction(DatabaseFacade, DbTransaction).

Обратите внимание, что текущий ExecutionStrategy метод не используется этим методом, так как SQL не может быть идемпотентным и не выполняется в транзакции. Метод ExecutionStrategy можно использовать явным образом, не забудьте также использовать транзакцию, если SQL не является идемпотентным.

Как и в случае с любым API, принимающего SQL, важно параметризовать любые входные данные пользователя для защиты от атаки внедрения SQL. Можно включить держатели параметров в строку запроса SQL, а затем указать значения параметров в качестве дополнительных аргументов. Все указанные значения параметров автоматически преобразуются в DbParameter. Вы также можете использовать ExecuteSqlInterpolated для использования интерполированного синтаксиса строки для создания параметров.

ExecuteSqlCommandAsync(DatabaseFacade, RawSqlString, Object[])
Устаревшие.

Выполняет заданный SQL для базы данных и возвращает количество затронутых строк.

Обратите внимание, что этот метод не запускает транзакцию. Чтобы использовать этот метод с транзакцией, сначала вызовите BeginTransaction(DatabaseFacade, IsolationLevel) или UseTransaction(DatabaseFacade, DbTransaction).

Обратите внимание, что текущий ExecutionStrategy метод не используется этим методом, так как SQL не может быть идемпотентным и не выполняется в транзакции. Метод ExecutionStrategy можно использовать явным образом, не забудьте также использовать транзакцию, если SQL не является идемпотентным.

Как и в случае с любым API, принимающего SQL, важно параметризовать любые входные данные пользователя для защиты от атаки внедрения SQL. Можно включить держатели параметров в строку запроса SQL, а затем указать значения параметров в качестве дополнительных аргументов. Все указанные значения параметров автоматически преобразуются в DbParameter . context.Database.ExecuteSqlCommandAsync("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm) Вы также можете использовать ExecuteSqlInterpolated для использования интерполированного синтаксиса строки для создания параметров.

ExecuteSqlCommandAsync(DatabaseFacade, String, CancellationToken, Object[])

Предоставляет доступ к связанным сведениям и операциям базы данных для контекста. Экземпляры этого класса обычно получаются и Database не предназначены для непосредственного создания в коде приложения.

ExecuteSqlInterpolated(DatabaseFacade, FormattableString)
Устаревшие.

Выполняет заданный SQL для базы данных и возвращает количество затронутых строк.

ExecuteSqlInterpolatedAsync(DatabaseFacade, FormattableString, CancellationToken)
Устаревшие.

Выполняет заданный SQL для базы данных и возвращает количество затронутых строк.

ExecuteSqlRaw(DatabaseFacade, String, IEnumerable<Object>)

Выполняет заданный SQL для базы данных и возвращает количество затронутых строк.

ExecuteSqlRaw(DatabaseFacade, String, Object[])

Выполняет заданный SQL для базы данных и возвращает количество затронутых строк.

ExecuteSqlRawAsync(DatabaseFacade, String, CancellationToken)

Выполняет заданный SQL для базы данных и возвращает количество затронутых строк.

ExecuteSqlRawAsync(DatabaseFacade, String, IEnumerable<Object>, CancellationToken)

Выполняет заданный SQL для базы данных и возвращает количество затронутых строк.

ExecuteSqlRawAsync(DatabaseFacade, String, Object[])

Выполняет заданный SQL для базы данных и возвращает количество затронутых строк.

GenerateCreateScript(DatabaseFacade)

Создает скрипт для создания всех таблиц для текущей модели.

GetAppliedMigrations(DatabaseFacade)

Возвращает все миграции, примененные к целевой базе данных.

GetAppliedMigrationsAsync(DatabaseFacade, CancellationToken)

Асинхронно получает все миграции, примененные к целевой базе данных.

GetCommandTimeout(DatabaseFacade)

Возвращает время ожидания (в секундах) для команд, выполняемых с этим DbContextпараметром.

GetConnectionString(DatabaseFacade)

Возвращает базовый строка подключения, настроенный для этогоDbContext.

GetCosmosClient(DatabaseFacade)

Получает базовый CosmosClient для этого DbContext.

GetCosmosDatabaseId(DatabaseFacade)

Возвращает настроенного имени базы данных для этого DbContext.

GetDbConnection(DatabaseFacade)

Получает базовый ADO.NET DbConnection для этогоDbContext.

GetEnlistedTransaction(DatabaseFacade)

Возвращает текущую заверяемую транзакцию.

GetInfrastructure<T>(IInfrastructure<T>)

Возвращает значение из свойства, скрытого с помощью IInfrastructure<T>.

Этот метод обычно используется поставщиками баз данных (и другими расширениями). Обычно он не используется в коде приложения.

GetMigrations(DatabaseFacade)

Возвращает все миграции, определенные в настроенной сборке миграции.

GetPendingMigrations(DatabaseFacade)

Получает все миграции, определенные в сборке, но не примененные к целевой базе данных.

GetPendingMigrationsAsync(DatabaseFacade, CancellationToken)

Асинхронно получает все миграции, определенные в сборке, но не применены к целевой базе данных.

GetSessionToken(DatabaseFacade)

Возвращает составной маркер сеанса для контейнера по умолчанию для этого DbContext.

GetSessionTokens(DatabaseFacade)

Получает словарь, содержащий составной маркер сеанса для каждого контейнера для этого DbContext.

HasPendingModelChanges(DatabaseFacade)

Возвращает, true если модель имеет ожидающие изменения, которые будут применены.

IsCosmos(DatabaseFacade)

Возвращает, true если используемый в данный момент поставщик базы данных является поставщиком Cosmos.

IsInMemory(DatabaseFacade)

Возвращает, true если поставщик базы данных в настоящее время используется поставщиком в памяти.

IsRelational(DatabaseFacade)

Возвращает, true если поставщик базы данных в настоящее время использует реляционную базу данных.

IsSqlite(DatabaseFacade)

Возвращает, true если используемый в данный момент поставщик базы данных является поставщиком SQLite.

IsSqlServer(DatabaseFacade)

Возвращает, true если используемый в данный момент поставщик базы данных является поставщиком SQL Server.

Migrate(DatabaseFacade, String)

Применяет миграции для контекста к базе данных. Создаст базу данных, если она еще не существует.

Migrate(DatabaseFacade)

Применяет все ожидающие миграции для контекста к базе данных. Создаст базу данных, если она еще не существует.

MigrateAsync(DatabaseFacade, CancellationToken)

Асинхронно применяет все ожидающие миграции для контекста к базе данных. Создаст базу данных, если она еще не существует.

MigrateAsync(DatabaseFacade, String, CancellationToken)

Асинхронно применяет миграцию контекста к базе данных. Создаст базу данных, если она еще не существует.

OpenConnection(DatabaseFacade)

Открывает базовый DbConnectionобъект.

OpenConnectionAsync(DatabaseFacade, CancellationToken)

Открывает базовый DbConnectionобъект.

SetCommandTimeout(DatabaseFacade, Nullable<Int32>)

Задает время ожидания (в секундах), используемое для команд, выполняемых с этим DbContextпараметром.

SetCommandTimeout(DatabaseFacade, TimeSpan)

Задает время ожидания, используемое для команд, выполняемых с этим DbContextпараметром.

SetConnectionString(DatabaseFacade, String)

Задает базовый строка подключения, настроенный для этогоDbContext.

SetDbConnection(DatabaseFacade, DbConnection, Boolean)

Задает базовый ADO.NET DbConnection для этогоDbContext.

SetDbConnection(DatabaseFacade, DbConnection)

Задает базовый ADO.NET DbConnection для этогоDbContext.

SqlQuery<TResult>(DatabaseFacade, FormattableString)

Создает запрос LINQ на основе необработанного SQL-запроса, который возвращает результирующий набор скалярного типа, который изначально поддерживается поставщиком базы данных.

SqlQueryRaw<TResult>(DatabaseFacade, String, Object[])

Создает запрос LINQ на основе необработанного SQL-запроса, который возвращает результирующий набор скалярного типа, который изначально поддерживается поставщиком базы данных.

UseSessionToken(DatabaseFacade, String)

Задает составной маркер сеанса для контейнера по умолчанию для этого DbContext.

UseSessionTokens(DatabaseFacade, IReadOnlyDictionary<String,String>)

Задает маркер составных сеансов для каждого контейнера с DbContext маркерами, указанными в sessionTokens.

UseTransaction(DatabaseFacade, DbTransaction, Guid)

Задает для DbTransaction использования операциями базы данных операции с DbContext.

UseTransaction(DatabaseFacade, DbTransaction)

Задает для DbTransaction использования операциями базы данных операции с DbContext.

UseTransactionAsync(DatabaseFacade, DbTransaction, CancellationToken)

Задает для DbTransaction использования операциями базы данных операции с DbContext.

UseTransactionAsync(DatabaseFacade, DbTransaction, Guid, CancellationToken)

Задает для DbTransaction использования операциями базы данных операции с DbContext.

Применяется к