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 - пространство имен