ApplicationDbContext
dotnet ef database update ReplaceTimeStamp
-c AutoLot.Samples.ApplicationDbContext
Теперь база данных соответствует вашей модели.
Аннотации и навигационные свойства
Аннотация
ForeignKey
позволяет EF Core знать, какое свойство является поддерживающим полем для навигационного свойства. По соглашению
<ИмяТипа>Id
автоматически станет свойством внешнего ключа, но в предыдущем примере оно было установлено явно. Такой подход обеспечивает отличающиеся стили именования, а также наличие в таблице более одного внешнего ключа. Кроме того, улучшается читабельность кода.
Свойство
InverseProperty
информирует EF Core о способе связывания таблиц, указывая навигационное свойство в других сущностях, которое направляет обратно в текущую сущность. Свойство
InverseProperty
требуется, когда сущность связана с другой сущностью несколько раз, и вдобавок делает код более читабельным.
Интерфейс Fluent API
С помощью интерфейса Fluent API сущности приложения конфигурируются посредством кода С#. Методы предоставляются экземпляром
ModelBuilder
, доступным в методе
OnModelCreating()
класса
DbContext
. Интерфейс Fluent API является самым мощным способом конфигурирования и переопределяет любые конфликтующие между собой соглашения или аннотации данных. Некоторые конфигурационные параметры доступны только через Fluent API, скажем, стандартные значения для настроек и каскадное поведение для навигационных свойств.
Отображение классов и свойств
В следующем коде воспроизведен предыдущий пример
Car
с использованием Fluent API вместо аннотаций данных (здесь не показаны навигационные свойства, которые будут раскрыты ниже):
modelBuilder.Entity<Car>(entity =>
{
entity.ToTable("Inventory","dbo");
entity.HasKey(e=>e.Id);
entity.HasIndex(e => e.MakeId, "IX_Inventory_MakeId");
entity.Property(e => e.Color)
.IsRequired()
.HasMaxLength(50);
entity.Property(e => e.PetName)
.IsRequired()
.HasMaxLength(50);
entity.Property(e => e.TimeStamp)
.IsRowVersion()
.IsConcurrencyToken();
});
Если создать и запустить миграцию прямо сейчас, то вы обнаружите, что ничего не изменилось, поскольку вызываемые методы Fluent API соответствуют текущей конфигурации, определенной соглашениями и аннотациями данных.
Стандартные значения
Интерфейс Fluent API предлагает методы, позволяющие устанавливать стандартные значения для столбцов. Стандартное значение может иметь тип значения или быть строкой SQL. Например, вот как установить стандартное значение
Color
для новой сущности
Car
в
Black
:
modelBuilder.Entity<Car>(entity =>
{
...
entity.Property(e => e.Color)
.HasColumnName("CarColor")
.IsRequired()
.HasMaxLength(50)
<b> .HasDefaultValue("Black");</b>
});
Чтобы установить значение для функции базы данных (вроде
getdate()
), применяйте метод
HasDefaultValueSql()
. Предположим, что в класс
Car
было добавлено свойство
DateTime
по имени
DateBuilt
, а стандартным значением должна быть текущая дата, получаемая с использованием метода
getdate()
в SQL Server. Столбцы конфигурируются следующим образом:
modelBuilder.Entity<Car>(entity =>
{
...
entity.Property(e => e.DateBuilt)
.HasDefaultValueSql("getdate()");
});
Как и в случае применения SQL для вставки записи, если свойство, которое отображается на столбец со стандартным значением, имеет значение, когда EF Core вставляет запись, то вместо стандартного значения столбца будет использоваться значение свойства. Если значение свойства равно
null
, тогда применяется стандартное значение столбца.
Проблема возникает при наличии стандартного значения у типа данных свойства. Вспомните, что стандартное значение для числовых типов составляет
0
, а для булевских —
false
. Если вы установите значение числового свойства в
0
или булевского свойства в
false
и затем вставите такую сущность, тогда инфраструктура EF Core будет трактовать это свойство как
не имеющее установленного значения. При отображении свойства на столбец со стандартным значением используется стандартное значение в определении столбца.
Например, добавьте в класс
Car
свойство типа
bool
по имени
IsDrivable
. Установите в
true
стандартное значение для отображения свойства на столбец:
// Car.cs
public class Car : BaseEntity
{
...
<b> public bool IsDrivable { get; set; }</b>
}
