Часть 7. Добавление нового поля на страницу Razor в ASP.NET Core

Автор: Рик Андерсон (Rick Anderson)

В этом разделе Entity Framework Core (EF Core) используется для определения схемы базы данных на основе класса модели приложения:

• Добавление нового поля в модель.
• Перенос изменений в схеме нового поля в базу данных.

Этот EF Core подход обеспечивает более гибкий процесс разработки. Разработчик работает с моделью данных приложения непосредственно во время создания схемы базы данных, а затем синхронизируется, все без необходимости переключить контексты на средство управления datbase и из него. Общие сведения о Entity Framework Core и его преимуществах см. в разделе Entity Framework Core.

Использование EF Code для автоматического создания и отслеживания базы данных:

• Добавляет в базу данных таблицу __EFMigrationsHistory, которая позволяет отслеживать синхронизацию схемы базы данных с классами модели, на основе которой она была создана.
• Если классы модели не синхронизированы с базой данных, выдает исключение.

Автоматическая проверка синхронизации схемы и модели упрощает поиск несогласованных проблем в коде базы данных.

Добавление свойства Rating в модель Movie

1. Models/Movie.cs Откройте файл и добавьте Rating свойство:

   public class Movie
   {
       public int Id { get; set; }
       public string Title { get; set; } = string.Empty;
   
       [Display(Name = "Release Date")]
       [DataType(DataType.Date)]
       public DateTime ReleaseDate { get; set; }
       public string Genre { get; set; } = string.Empty;
   
       [Column(TypeName = "decimal(18, 2)")]
       public decimal Price { get; set; }
       public string Rating { get; set; } = string.Empty;
   }
   

2. Отредактируйте Pages/Movies/Index.cshtml и добавьте поле Rating:

   @page
   @model RazorPagesMovie.Pages.Movies.IndexModel
   
   @{
       ViewData["Title"] = "Index";
   }
   
   <h1>Index</h1>
   
   <p>
       <a asp-page="Create">Create New</a>
   </p>
   
   <form>
       <p>
           <select asp-for="MovieGenre" asp-items="Model.Genres">
               <option value="">All</option>
           </select>
           <label>Title: <input type="text" asp-for="SearchString" /></label>
           <input type="submit" value="Filter" />
       </p>
   </form>
   
   <table class="table">
   
       <thead>
           <tr>
               <th>
                   @Html.DisplayNameFor(model => model.Movie[0].Title)
               </th>
               <th>
                   @Html.DisplayNameFor(model => model.Movie[0].ReleaseDate)
               </th>
               <th>
                   @Html.DisplayNameFor(model => model.Movie[0].Genre)
               </th>
               <th>
                   @Html.DisplayNameFor(model => model.Movie[0].Price)
               </th>
               <th>
                   @Html.DisplayNameFor(model => model.Movie[0].Rating)
               </th>
               <th></th>
           </tr>
       </thead>
       <tbody>
           @foreach (var item in Model.Movie)
           {
               <tr>
                   <td>
                       @Html.DisplayFor(modelItem => item.Title)
                   </td>
                   <td>
                       @Html.DisplayFor(modelItem => item.ReleaseDate)
                   </td>
                   <td>
                       @Html.DisplayFor(modelItem => item.Genre)
                   </td>
                   <td>
                       @Html.DisplayFor(modelItem => item.Price)
                   </td>
                   <td>
                       @Html.DisplayFor(modelItem => item.Rating)
                   </td>
                   <td>
                       <a asp-page="./Edit" asp-route-id="@item.Id">Edit</a> |
                       <a asp-page="./Details" asp-route-id="@item.Id">Details</a> |
                       <a asp-page="./Delete" asp-route-id="@item.Id">Delete</a>
                   </td>
               </tr>
           }
       </tbody>
   </table>
   

3. Обновите следующие страницы, добавив поле Rating:

   • Pages/Movies/Create.cshtml.
   • Pages/Movies/Delete.cshtml.
   • Pages/Movies/Details.cshtml.
   • Pages/Movies/Edit.cshtml.

Для работы приложения необходимо обновить базу данных, включив в нее новое поле. При запуске приложения без обновления базы данных возникает SqlException:

SqlException: Invalid column name 'Rating'.

Исключение SqlException связано с тем, что обновленный класс модели Movie отличается от схемы таблицы Movie в базе данных. В таблице базы данных нет столбца Rating.

Устранить эту ошибку можно несколькими способами:

1. Можно с помощью Entity Framework автоматически удалить и повторно создать базу данных на основе новой схемы класса модели. Этот подход удобен на ранних стадиях цикла разработки. В этом случае развитие модели и схемы базы данных осуществляется одновременно. Недостатком такого подхода является потеря существующих данных в базе. В рабочей базе данных применять этот подход не следует! При разработке приложения часто выполняется удаление базы данных при изменении схемы, для чего используется инициализатор для автоматического заполнения базы тестовыми данными.
2. Можно явно изменить схему существующей базы данных в соответствии с новыми классами модели. Преимущество подхода в том, что он сохраняет данные. Внесите это изменение вручную либо путем создания скрипта изменения для базы данных.
3. Используйте EF Core миграции для обновления схемы базы данных.

В этом руководстве используйте EF Core миграции.

Обновите класс SeedData так, чтобы он предоставлял значение нового столбца. Ниже приведен пример изменения, которое необходимо реализовать для каждого блока new Movie.

context.Movie.AddRange(
    new Movie
    {
        Title = "When Harry Met Sally",
        ReleaseDate = DateTime.Parse("1989-2-12"),
        Genre = "Romantic Comedy",
        Price = 7.99M,
        Rating = "R"
    },

См. готовый файл SeedData.cs.

Создание приложения

Visual Studio

Нажмите клавиши CTRL+SHIFT B+

Visual Studio Code

В меню "Вид" выберите "Терминал" и введите следующую команду:

dotnet build

Visual Studio

Добавление миграции для поля Rating

1. В меню Сервис последовательно выберите пункты Диспетчер пакетов NuGet > Консоль диспетчера пакетов.

2. В консоли диспетчер пакетов (PMC) введите следующую команду:

   Add-Migration Rating
   

Команда Add-Migration задает следующие инструкции для платформы:

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

В качестве имени файла переноса используется произвольное имя "Rating". Рекомендуется присваивать этому файлу понятное имя.

2. В PMC введите следующую команду:

   Update-Database
   

Команда Update-Database указывает платформе, что к базе данных нужно применить изменения схемы, а также сохранить существующие данные.

Если удалить все записи из базы данных, при инициализации она будет заполнена начальными значениями и в нее будет включено поле Rating. Это можно сделать с помощью ссылок удаления в браузере или из обозревателя объектов SQL Server (SSOX).

Другой вариант — удалить базу данных и использовать миграции для повторного создания базы данных. Удаление базы данных в SSOX:

1. Выберите базу данных в SSOX.

2. Щелкните базу данных правой кнопкой мыши и выберите Удалить.

3. Выберите Закрыть существующие соединения.

4. Нажмите ОК.

5. Обновите базу данных в PMC.

   Update-Database
   

Visual Studio Code

Добавление переноса для оценки

Используйте следующие команды, чтобы добавить перенос для поля оценки:

dotnet ef migrations add rating
dotnet ef database update

Команда dotnet ef migrations add rating задает следующие инструкции для платформы:

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

В качестве имени файла переноса используется произвольное имя rating. Рекомендуется присваивать этому файлу понятное имя.

Команда dotnet ef database update указывает платформе, что к базе данных нужно применить изменения схемы, а также сохранить существующие данные.

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

Дополнительно: удалите и повторно создайте базу данных для других поставщиков

Пропустите этот раздел, если вы успешно выполнили миграцию базы данных.

В этом учебнике по возможности используются функции миграции Entity Framework Core. Во время миграции обновляется схема базы данных в соответствии с изменениями в модели данных. Однако миграции могут выполнять только типы изменений, поддерживаемых EF Core поставщиком, и некоторые возможности поставщика ограничены. Например, добавление столбца поддерживается, а удаление или изменение столбца — нет. Если миграция создается для удаления или изменения столбца, команда ef migrations add выполняется успешно, а команда ef database update — нет. Из-за этих ограничений можно удалить базу данных и создать ее повторно.

Обходной путь для ограничений — вручную написать код миграции для перестроения таблицы в случае изменений. Перестроение таблицы включает в себя:

• Создание новой таблицы.
• Копирование данных из старой таблицы в новую.
• Удаление старой таблицы.
• Переименование новой таблицы.

Дополнительные сведения см. на следующих ресурсах:

• Ограничения поставщика базы данных SQLite EF Core
• Настройка кода миграции
• Присвоение начальных значений данных
• Инструкция по ALTER TABLE SQLite

1. Удалите папку миграции.

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

   dotnet ef database drop
   dotnet ef migrations add InitialCreate
   dotnet ef database update
   

Запустите приложение и проверьте возможность создания, редактирования и отображения фильмов с использованием поля Rating. Если база данных не заполнена начальными значениями, задайте точку останова в методе SeedData.Initialize.

Следующие шаги

Предыдущая: добавление поискадалее: добавление проверки