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 с маркерами, указанными в |
| 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 . |
| 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 . |
| 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 . |
| ExecuteSqlCommandAsync(DatabaseFacade, RawSqlString, CancellationToken) |
Устаревшие.
Выполняет заданный SQL для базы данных и возвращает количество затронутых строк. Обратите внимание, что этот метод не запускает транзакцию. Чтобы использовать этот метод с транзакцией, сначала вызовите BeginTransaction(DatabaseFacade, IsolationLevel) или UseTransaction(DatabaseFacade, DbTransaction). Обратите внимание, что текущий ExecutionStrategy метод не используется этим методом, так как SQL не может быть идемпотентным и не выполняется в транзакции. Метод ExecutionStrategy можно использовать явным образом, не забудьте также использовать транзакцию, если SQL не является идемпотентным.
Как и в случае с любым API, принимающего SQL, важно параметризовать любые входные данные пользователя для защиты от атаки внедрения SQL. Можно включить держатели параметров в строку запроса SQL, а затем указать значения параметров в качестве дополнительных аргументов. Все указанные значения параметров автоматически преобразуются в DbParameter . |
| 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 . |
| 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) |
Возвращает, |
| IsCosmos(DatabaseFacade) |
Возвращает, |
| IsInMemory(DatabaseFacade) |
Возвращает, |
| IsRelational(DatabaseFacade) |
Возвращает, |
| IsSqlite(DatabaseFacade) |
Возвращает, |
| IsSqlServer(DatabaseFacade) |
Возвращает, |
| 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 маркерами, указанными в |
| UseTransaction(DatabaseFacade, DbTransaction, Guid) |
Задает для DbTransaction использования операциями базы данных операции с DbContext. |
| UseTransaction(DatabaseFacade, DbTransaction) |
Задает для DbTransaction использования операциями базы данных операции с DbContext. |
| UseTransactionAsync(DatabaseFacade, DbTransaction, CancellationToken) |
Задает для DbTransaction использования операциями базы данных операции с DbContext. |
| UseTransactionAsync(DatabaseFacade, DbTransaction, Guid, CancellationToken) |
Задает для DbTransaction использования операциями базы данных операции с DbContext. |