Поделиться через


HistoryContext - класс

[Эта страница относится к документации к Entity Framework 6. Последняя версия доступна в составе пакета Entity Framework NuGet. Дополнительные сведения об Entity Framework см. в разделе msdn.com/data/ef.]

Этот класс используется Code First Migrations для чтения и записи журнала миграции из базы данных. Чтобы настроить определение таблицы журнала миграций, можно создать класс, производный от этого класса, и переопределить OnModelCreating. Производные экземпляры можно регистрировать для каждой из конфигураций миграций с использованием SetHistoryContextFactory(String, Func<DbConnection, String, HistoryContext>) либо глобально с помощью SetDefaultHistoryContext(Func<DbConnection, String, HistoryContext>).

Иерархия наследования

System.Object
  System.Data.Entity.DbContext
    System.Data.Entity.Migrations.History.HistoryContext

Пространство имен:  System.Data.Entity.Migrations.History
Сборка:  EntityFramework (в EntityFramework.dll)

Синтаксис

'Декларация
Public Class HistoryContext _
    Inherits DbContext _
    Implements IDbModelCacheKeyProvider
'Применение
Dim instance As HistoryContext
public class HistoryContext : DbContext, 
    IDbModelCacheKeyProvider
public ref class HistoryContext : public DbContext, 
    IDbModelCacheKeyProvider
type HistoryContext =  
    class 
        inherit DbContext 
        interface IDbModelCacheKeyProvider 
    end
public class HistoryContext extends DbContext implements IDbModelCacheKeyProvider

Тип HistoryContext предоставляет следующие члены.

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

  Имя Описание
Открытый метод HistoryContext Инициализирует новый экземпляр класса HistoryContext.Если вы создаете производный контекст журнала, в общем случае вы предоставляете конструктор, который принимает те же параметры и передает их базовому конструктору.

По верхнему краю

Свойства

  Имя Описание
Открытое свойство CacheKey Возвращает ключ, используемый для поиска модели, ранее построенной для этого контекста.Это используется, чтобы избежать обработки OnModelCreating и вычисления модели каждый раз, когда создается новый экземпляр контекста.По умолчанию это свойство возвращает схему по умолчанию.В большинстве случаев переопределять это свойство не понадобится.Однако если ваша реализация OnModelCreating содержит условную логику, в соответствии с которой создается другая модель при том же поставщике баз данных и схеме по умолчанию, необходимо переопределить это свойство и вычислить соответствующий ключ.
Открытое свойство ChangeTracker Предоставляет доступ к функциям контекста, осуществляющим отслеживание изменений в сущностях. (Унаследовано от DbContext.)
Открытое свойство Configuration Предоставляет доступ к параметрам конфигурации контекста. (Унаследовано от DbContext.)
Открытое свойство Database Создает экземпляр базы данных для этого контекста, который позволяет выполнять создание, удаление или проверку существования основной базы данных. (Унаследовано от DbContext.)
Защищенное свойство DefaultSchema Возвращает схему по умолчанию для переносимой модели.Эта схема будет использоваться для таблицы журнала миграций, если в OnModelCreating не настроена другая схема.
Открытое свойство History Возвращает или задает объект DbSet<TEntity>, который можно использовать для считывания и записи экземпляров HistoryRow.

По верхнему краю

Методы

  Имя Описание
Открытый метод Dispose() Вызывает защищенный метод Dispose. (Унаследовано от DbContext.)
Защищенный метод Dispose(Boolean) Освобождает контекст.Базовый объект ObjectContext также удаляется, если был создан данным контекстом либо если при создании данного контекста этот объект был передан ему во владение.Соединение с базой данных (объект DbConnection) также освобождается, если оно было создано данным контекстом либо если при создании данного контекста это соединение было передано ему во владение. (Унаследовано от DbContext.)
Открытый метод Entry(Object) Возвращает для заданной сущности объект DbEntityEntry, предоставляющий доступ к сведениям о сущности и о возможности выполнения действий над ней. (Унаследовано от DbContext.)
Открытый метод Entry<TEntity>(TEntity) Возвращает для заданной сущности объект DbEntityEntry<TEntity>, предоставляющий доступ к сведениям о сущности и о возможности выполнения действий над ней. (Унаследовано от DbContext.)
Открытый метод Equals Определяет, равен ли заданный контекст DbContext текущему. (Унаследовано от DbContext.)
Защищенный метод Finalize (Унаследовано от Object.)
Открытый метод GetHashCode Возвращает хэш-функцию для данного контекста DBContext. (Унаследовано от DbContext.)
Открытый метод GetType Возвращает тип текущего контекста DbContext. (Унаследовано от DbContext.)
Открытый метод GetValidationErrors Проверяет отслеживаемые сущности и возвращает коллекцию DbEntityValidationResult, содержащую результаты проверки. (Унаследовано от DbContext.)
Защищенный метод MemberwiseClone (Унаследовано от Object.)
Защищенный метод OnModelCreating Применяет конфигурацию по умолчанию для таблицы журнала миграций.При переопределении этого метода рекомендуется вызвать эту базовую реализацию перед применением пользовательской конфигурации. (Переопределяет DbContext.OnModelCreating(DbModelBuilder).)
Открытый метод SaveChanges Сохраняет все изменения основной базы данных, произведенные в контексте. (Унаследовано от DbContext.)
Открытый метод SaveChangesAsync() Асинхронно сохраняет все изменения основной базы данных, произведенные в контексте. (Унаследовано от DbContext.)
Открытый метод SaveChangesAsync(CancellationToken) Асинхронно сохраняет все изменения основной базы данных, произведенные в контексте. (Унаследовано от DbContext.)
Открытый метод Set(Type) Возвращает неуниверсальный экземпляр DbSet для доступа к сущностям заданного типа в контексте и в базовом хранилище. (Унаследовано от DbContext.)
Открытый метод Set<TEntity>() Возвращает экземпляр DbSet<TEntity> для доступа к сущностям заданного типа в контексте и в базовом хранилище. (Унаследовано от DbContext.)
Защищенный метод ShouldValidateEntity Расширение, позволяющее пользователю переопределить поведение по умолчанию, предполагающее проверку только добавленных и измененных сущностей. (Унаследовано от DbContext.)
Открытый метод ToString Возвращает строковое представление контекста DbContext. (Унаследовано от DbContext.)
Защищенный метод ValidateEntity Расширение, позволяющее пользователю настраивать проверку сущности или отфильтровать результаты проверки.Вызывается методом GetValidationErrors(). (Унаследовано от DbContext.)

По верхнему краю

Поля

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

По верхнему краю

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

  Имя Описание
Явная реализация интерфейсаЗакрытое свойство IObjectContextAdapter.ObjectContext Возвращает объект Entity Framework ObjectContext, который является базовым для данного контекста. (Унаследовано от DbContext.)

По верхнему краю

Потокобезопасность

Любые открытые члены этого типа, объявленные как static (Shared в Visual Basic), являются потокобезопасными. Потокобезопасная работа с членами экземпляров типа не гарантируется.

См. также

Справочник

System.Data.Entity.Migrations.History - пространство имен