Część 7. Dodawanie nowego pola do Razor strony w ASP.NET Core

Autor: Rick Anderson

W tej sekcji program Entity Framework Migracje Code First jest używany do:

• Dodaj nowe pole do modelu.
• Przeprowadź migrację zmiany schematu nowego pola do bazy danych.

Jeśli używasz programu EF Code First do automatycznego tworzenia i śledzenia bazy danych, Code First:

• Dodaje tabelę __EFMigrationsHistory do bazy danych w celu śledzenia, czy schemat bazy danych jest zsynchronizowany z klasami modelu, z których został wygenerowany.
• Zgłasza wyjątek, jeśli klasy modelu nie są zsynchronizowane z bazą danych.

Automatyczna weryfikacja, czy schemat i model są zsynchronizowane, ułatwia znajdowanie niespójnych problemów z kodem bazy danych.

Dodawanie właściwości ratingu do modelu filmowego

1. Models/Movie.cs Otwórz plik i dodaj Rating właściwość:

   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. Edytuj Pages/Movies/Index.cshtml, i dodaj Rating pole:

   @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>
           Title: <input type="text" asp-for="SearchString" />
           <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. Zaktualizuj następujące strony przy użyciu Rating pola:

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

Aplikacja nie będzie działać, dopóki baza danych nie zostanie zaktualizowana w celu uwzględnienia nowego pola. Uruchomienie aplikacji bez aktualizacji bazy danych zgłasza błąd SqlException:

SqlException: Invalid column name 'Rating'.

Wyjątek jest spowodowany tym, że zaktualizowana SqlException klasa modelu Movie różni się od schematu tabeli Movie bazy danych. W tabeli bazy danych nie Rating ma żadnej kolumny.

Istnieje kilka podejść do rozwiązywania błędu:

1. Program Entity Framework automatycznie upuszcza i ponownie utwórz bazę danych przy użyciu nowego schematu klasy modelu. Takie podejście jest wygodne na wczesnym etapie cyklu tworzenia, dzięki czemu deweloperzy mogą szybko rozwijać schemat modelu i bazy danych. Wadą jest to, że istniejące dane w bazie danych zostaną utracone. Nie używaj tego podejścia w produkcyjnej bazie danych! Usunięcie bazy danych ze zmianami schematu i użycie inicjatora do automatycznego rozmieszczania bazy danych z danymi testowymi jest często produktywnym sposobem tworzenia aplikacji.
2. Jawnie zmodyfikuj schemat istniejącej bazy danych, tak aby odpowiadał klasom modelu. Zaletą tego podejścia jest przechowywanie danych. Wprowadź tę zmianę ręcznie lub tworząc skrypt zmiany bazy danych.
3. Użyj Migracje Code First, aby zaktualizować schemat bazy danych.

Na potrzeby tego samouczka użyj Migracje Code First.

Zaktualizuj klasę SeedData , aby zapewnić jej wartość dla nowej kolumny. Poniżej przedstawiono przykładową zmianę, ale wprowadź tę zmianę dla każdego new Movie bloku.

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

Zobacz ukończony plik SeedData.cs.

Tworzenie aplikacji

Program Visual Studio

Naciśnij klawisze Ctrl+Shift B+

Visual Studio Code

W menu Widok wybierz pozycję Terminal i wprowadź następujące polecenie:

dotnet build

Visual Studio dla komputerów Mac

Naciśnij przycisk {+B

Program Visual Studio

Dodawanie migracji dla pola klasyfikacji

1. W menu Narzędzia wybierz pozycję NuGet Menedżer pakietów > konsoli Menedżer pakietów.

2. W usłudze PMC wprowadź następujące polecenia:

   Add-Migration Rating
   Update-Database
   

Polecenie Add-Migration informuje platformę o następującej liczbie:

• Movie Porównaj model ze schematem Movie bazy danych.
• Utwórz kod, aby przeprowadzić migrację schematu bazy danych do nowego modelu.

Nazwa "Ocena" jest dowolna i służy do nazywania pliku migracji. Warto użyć znaczącej nazwy pliku migracji.

Polecenie Update-Database informuje platformę o zastosowaniu zmian schematu w bazie danych i zachowaniu istniejących danych.

Usuń wszystkie rekordy w bazie danych, inicjator zaimekuje bazę danych i dołączy Rating pole. Usuwanie można wykonać za pomocą linków usuwania w przeglądarce lub z programu Sql Server Eksplorator obiektów (SSOX).

Inną opcją jest usunięcie bazy danych i ponowne utworzenie bazy danych przy użyciu migracji. Aby usunąć bazę danych w programie SSOX:

1. Wybierz bazę danych w programie SSOX.

2. Kliknij prawym przyciskiem myszy bazę danych i wybierz polecenie Usuń.

3. Zaznacz pozycję Zamknij istniejące połączenia.

4. Wybierz przycisk OK.

5. W usłudze PMC zaktualizuj bazę danych:

   Update-Database
   

Visual Studio Code/Visual Studio dla komputerów Mac

Dodawanie migracji do oceny

Użyj następujących poleceń, aby dodać migrację dla pola klasyfikacji:

dotnet ef migrations add rating
dotnet ef database update

Polecenie dotnet-ef migrations add rating informuje platformę o następującej liczbie:

• Movie Porównaj model ze schematem Movie bazy danych.
• Utwórz kod, aby przeprowadzić migrację schematu bazy danych do nowego modelu.

Nazwa rating jest dowolna i służy do nazywania pliku migracji. Warto użyć znaczącej nazwy pliku migracji.

Polecenie dotnet-ef database update informuje platformę o zastosowaniu zmian schematu w bazie danych i zachowaniu istniejących danych.

Usuń wszystkie rekordy w bazie danych, inicjator zaimekuje bazę danych i dołączy Rating pole.

Opcjonalnie: Upuść i ponownie utwórz bazę danych dla innych dostawców

Pomiń tę sekcję, jeśli baza danych została pomyślnie zmigrowana.

W tym samouczku funkcje migracji platformy Entity Framework Core są używane, gdy jest to możliwe. Migracje aktualizują schemat bazy danych w celu dopasowania zmian w modelu danych. Jednak migracje mogą wykonywać tylko rodzaje zmian, które EF Core obsługuje dostawca, a niektóre możliwości dostawcy są ograniczone. Na przykład dodanie kolumny może być obsługiwane, ale usunięcie lub zmiana kolumny nie jest. Jeśli migracja zostanie utworzona w celu usunięcia lub zmiany kolumny, polecenie powiedzie się, ef migrations add ale polecenie zakończy się niepowodzeniem ef database update . Ze względu na te ograniczenia można usunąć i ponownie utworzyć bazę danych.

Obejściem ograniczeń jest ręczne napisanie kodu migracji w celu ponownego skompilowania tabeli w przypadku zmiany elementu w tabeli. Ponowne kompilowanie tabeli obejmuje:

• Tworzenie nowej tabeli.
• Kopiowanie danych ze starej tabeli do nowej tabeli.
• Upuszczanie starej tabeli.
• Zmiana nazwy nowej tabeli.

Aby uzyskać więcej informacji, zobacz następujące zasoby:

• Ograniczenia dostawcy bazy danych SQLite EF Core
• Dostosowywanie kodu migracji
• Rozmieszczanie danych
• SQLite ALTER TABLE, instrukcja

1. Usuń folder migracji.

2. Użyj następujących poleceń, aby ponownie utworzyć bazę danych.

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

Uruchom aplikację i sprawdź, czy możesz tworzyć, edytować i wyświetlać filmy z polem Rating . Jeśli baza danych nie jest rozstawiona, ustaw punkt przerwania w metodzie SeedData.Initialize .

Następne kroki

Poprzedni: Dodaj wyszukiwaniedalej: Dodaj walidację