Язык

DbContext Класс

Определение

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

[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Naming", "CA1709:IdentifiersShouldBeCasedCorrectly", Justification="Casing is intentional")]
public class DbContext : IDisposable, System.Data.Entity.Infrastructure.IObjectContextAdapter
public class DbContext : IDisposable, System.Data.Entity.Infrastructure.IObjectContextAdapter
type DbContext = class
    interface IDisposable
    interface IObjectContextAdapter
Public Class DbContext
Implements IDisposable, IObjectContextAdapter
Наследование
DbContext
Производный
Атрибуты
Реализации

Комментарии

DbContext обычно используется с производным типом, который содержит DbSet<TEntity> свойства для корневых сущностей модели. Эти наборы автоматически инициализированы при создании экземпляра производного класса. Это поведение можно изменить, применяя SuppressDbSetInitializationAttribute атрибут ко всему производного класса контекста или к отдельным свойствам класса. Модель данных сущности, поддерживаемая контекстом, может быть указана несколькими способами. При использовании первого подхода DbSet<TEntity> в коде свойства в производном контексте используются для создания модели по соглашению. Защищенный метод OnModelCreating можно переопределить для настройки этой модели. Более подробный контроль над моделью, используемой для первого подхода модели, можно получить путем создания явного метода DbCompiledModel из DbModelBuilder модели и передачи этой модели в один из конструкторов DbContext. При использовании первого или модельного подхода к модели данных сущности можно создать с помощью конструктора сущностей (или вручную путем создания файла EDMX), а затем эту модель можно указать с помощью сущности строка подключения или EntityConnection объекта. Подключение к базе данных (включая имя базы данных) можно указать несколькими способами. Если конструктор DbContext без параметров вызывается из производного контекста, то имя производного контекста используется для поиска строка подключения в файле app.config или web.config. Если строка подключения не найдено, то имя передается в свойство DefaultConnectionFactory, зарегистрированного Database в классе. Затем фабрика подключений использует имя контекста в качестве имени базы данных в строка подключения по умолчанию. (Этот параметр по умолчанию строка подключения указывает на .\SQLEXPRESS на локальном компьютере, если не зарегистрирован другой объект DefaultConnectionFactory.) Вместо использования производного имени контекста можно также явно указать имя подключения или базы данных, передав имя одному из конструкторов DbContext, принимающим строку. Имя также можно передать в форме "name=myname", в этом случае имя должно быть найдено в файле конфигурации или будет создано исключение. Обратите внимание, что подключение, найденное в файле app.config или web.config, может быть обычной базой данных строка подключения (а не специальной строка подключения Entity Framework), в этом случае DbContext будет использовать code First. Однако если подключение, найденное в файле конфигурации, является специальной строка подключения Entity Framework, то DbContext будет использовать Database/Model First, а модель, указанную в строка подключения, будет использоваться. Существующий или явно созданный DbConnection также можно использовать вместо имени базы данных или подключения. Можно DbModelBuilderVersionAttribute применить к классу, производным от DbContext, чтобы задать версию соглашений, используемых контекстом при создании модели. Если атрибут не применяется, будет использоваться последняя версия соглашений.

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

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

Создает новый экземпляр контекста с помощью соглашений, чтобы создать имя базы данных, к которой будет выполнено подключение. Имя по соглашению — это полное имя (пространство имен + имя класса) производного класса контекста. Сведения о том, как это используется для создания подключения, см. в примечаниях класса.

DbContext(DbCompiledModel)

Создает новый экземпляр контекста с помощью соглашений, чтобы создать имя базы данных, к которой будет выполнено подключение, и инициализирует его из данной модели. Имя по соглашению — это полное имя (пространство имен + имя класса) производного класса контекста. Сведения о том, как это используется для создания подключения, см. в примечаниях класса.

DbContext(DbConnection, Boolean)

Создает новый экземпляр контекста, используя существующее подключение для подключения к базе данных. Подключение не будет удалено, если контекст удаляется contextOwnsConnectionfalse.

DbContext(DbConnection, DbCompiledModel, Boolean)

Создает новый экземпляр контекста с помощью существующего подключения для подключения к базе данных и инициализирует его из данной модели. Подключение не будет удалено, если контекст удаляется contextOwnsConnectionfalse.

DbContext(ObjectContext, Boolean)

Создает новый экземпляр контекста вокруг существующего объекта ObjectContext.

DbContext(ObjectContext, Boolean)

Создает новый экземпляр контекста вокруг существующего объекта ObjectContext.

<param name="objectContext">Существующий объект ObjectContext для упаковки с новым контекстом.</param param param><name="dbContextOwnsObjectContext">, если задано значение true ObjectContext при удалении DbContext, в противном случае вызывающий объект должен удалить соединение.</param>
DbContext(String, DbCompiledModel)

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

DbContext(String)

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

Свойства

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

Предоставляет доступ к функциям контекста, который занимается отслеживанием изменений сущностей.

Configuration

Предоставляет доступ к параметрам конфигурации для контекста.

Database

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

Методы

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

Вызывает защищенный метод Dispose.

Dispose(Boolean)

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

Entry(Object)

DbEntityEntry Получает объект для данной сущности, предоставляющий доступ к сведениям об сущности и возможности выполнять действия в сущности.

Entry<TEntity>(TEntity)

DbEntityEntry<TEntity> Получает объект для данной сущности, предоставляющий доступ к сведениям об сущности и возможности выполнять действия в сущности.

Equals(Object)

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

GetHashCode()

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

GetType()

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

GetValidationErrors()

Проверяет отслеживаемые сущности и возвращает коллекцию DbEntityValidationResult содержащих результаты проверки.

OnModelCreating(DbModelBuilder)

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

SaveChanges()

Сохраняет все изменения, внесенные в этот контекст, в базовую базу данных.

SaveChangesAsync()

Асинхронно сохраняет все изменения, внесенные в этот контекст, в базовую базу данных.

SaveChangesAsync(CancellationToken)

Асинхронно сохраняет все изменения, внесенные в этот контекст, в базовую базу данных.

Set(Type)

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

Set<TEntity>()

DbSet<TEntity> Возвращает экземпляр для доступа к сущностям заданного типа в контексте и базовом хранилище.

ShouldValidateEntity(DbEntityEntry)

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

ToString()

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

ValidateEntity(DbEntityEntry, IDictionary<Object,Object>)

Точка расширения позволяет пользователю настраивать проверку сущности или отфильтровать результаты проверки. Вызывается методом GetValidationErrors().

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

Имя. Описание
IObjectContextAdapter.ObjectContext

Возвращает объект Entity Framework ObjectContext, лежащий в основе этого контекста.

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