DbModelBuilder Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
DbModelBuilder используется для сопоставления классов CLR с схемой базы данных. Этот подход, ориентированный на код для создания модели данных сущности (EDM), называется Code First.
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Naming", "CA1709:IdentifiersShouldBeCasedCorrectly", MessageId="Db")]
public class DbModelBuilder
public class DbModelBuilder
type DbModelBuilder = class
Public Class DbModelBuilder
- Наследование
-
DbModelBuilder
- Атрибуты
Комментарии
DbModelBuilder обычно используется для настройки модели путем переопределения DbContext.OnModelCreating(DbModelBuilder). DbModelBuilder можно также использовать независимо от DbContext для создания модели, а затем создания DbContext или ObjectContext. Однако рекомендуемый подход заключается в том, чтобы использовать OnModelCreating в DbContext работе, так как рабочий процесс более интуитивно понятен и отвечает за распространенные задачи, такие как кэширование созданной модели. Типы, формирующие модель, регистрируются в DbModelBuilder и необязательной конфигурации, можно выполнить путем применения заметок данных к классам и (или) с помощью api DbModelBuilder в стиле fluent style DbModelBuilder. При вызове метода Build выполняется набор соглашений для обнаружения начальной модели. Эти соглашения автоматически обнаруживают аспекты модели, такие как первичные ключи, а также обрабатывают любые заметки данных, указанные в классах. Наконец, применяется любая конфигурация, выполненная с помощью API DbModelBuilder. Конфигурация, выполненная с помощью API DbModelBuilder, имеет приоритет над заметками данных, которые, в свою очередь, имеют приоритет над соглашениями по умолчанию.
Конструкторы
| Имя. | Описание |
|---|---|
| DbModelBuilder() |
Инициализирует новый экземпляр класса DbModelBuilder. Процесс обнаружения начальной модели будет использовать набор соглашений, включенных в последнюю версию Entity Framework, установленной на компьютере. |
| DbModelBuilder(DbModelBuilderVersion) |
Инициализирует новый экземпляр DbModelBuilder класса, который будет использовать определенный набор соглашений для обнаружения начальной модели. |
Свойства
| Имя. | Описание |
|---|---|
| Configurations |
ConfigurationRegistrar Возвращает значение для этого DbModelBuilder. Регистратор позволяет регистрировать производные сущности и сложные конфигурации типов в этом построителе. |
| Conventions |
Предоставляет доступ к параметрам этого DbModelBuilder, который занимается соглашениями. |
Методы
| Имя. | Описание |
|---|---|
| Build(DbConnection) |
DbModel Создает конфигурацию на основе конфигурации, выполняемой с помощью этого построителя. Подключение используется для определения поставщика базы данных, используемого так как это влияет на уровень базы данных созданной модели. |
| Build(DbProviderInfo) |
DbModel Создает конфигурацию на основе конфигурации, выполняемой с помощью этого построителя. Необходимо указать сведения о поставщике, так как это влияет на уровень базы данных созданной модели. Для SqlClient инвариантное имя — System.Data.SqlClient, а маркер манифеста — год версии (т. е. "2005", "2008" и т. д.). |
| ComplexType<TComplexType>() |
Регистрирует тип как сложный тип в модели и возвращает объект, который можно использовать для настройки сложного типа. Этот метод можно вызывать несколько раз для одного типа для выполнения нескольких строк конфигурации. |
| Entity<TEntityType>() |
Регистрирует тип сущности в составе модели и возвращает объект, который можно использовать для настройки сущности. Этот метод можно вызывать несколько раз для одной сущности для выполнения нескольких строк конфигурации. |
| Equals(Object) |
DbModelBuilder используется для сопоставления классов CLR с схемой базы данных. Этот подход, ориентированный на код для создания модели данных сущности (EDM), называется Code First. |
| GetHashCode() |
DbModelBuilder используется для сопоставления классов CLR с схемой базы данных. Этот подход, ориентированный на код для создания модели данных сущности (EDM), называется Code First. |
| GetType() |
Возвращает Type текущего экземпляра. |
| HasDefaultSchema(String) |
Настраивает имя схемы базы данных по умолчанию. Это имя схемы базы данных по умолчанию используется для объектов базы данных, которые не имеют явно настроенного имени схемы. |
| Ignore(IEnumerable<Type>) |
Исключает указанные типи из модели. Это используется для удаления типов из модели, добавляемой соглашением во время первоначального обнаружения моделей. |
| Ignore<T>() |
Исключает тип из модели. Это используется для удаления типов из модели, добавляемой соглашением во время первоначального обнаружения моделей. |
| Properties() |
Начинает настройку упрощенного соглашения, которое применяется ко всем свойствам в модели. |
| Properties<T>() |
Начинает настройку упрощенного соглашения, которое применяется ко всем примитивным свойствам указанного типа в модели. |
| RegisterEntityType(Type) |
Регистрирует тип сущности в рамках модели. |
| ToString() |
DbModelBuilder используется для сопоставления классов CLR с схемой базы данных. Этот подход, ориентированный на код для создания модели данных сущности (EDM), называется Code First. |
| Types() |
Начинает настройку упрощенного соглашения, которое применяется ко всем сущностям и сложным типам в модели. |
| Types<T>() |
Начинает настройку упрощенного соглашения, которое применяется ко всем сущностям и сложным типам в модели, наследуемой от или реализующей тип, заданный универсальным аргументом. Этот метод не регистрирует типы в рамках модели. |