Bagian 7, tambahkan bidang baru ke Razor Halaman di ASP.NET Core

Oleh Rick Anderson

Di bagian ini Entity Framework Core (EF Core) digunakan untuk menentukan skema database berdasarkan kelas model aplikasi:

• Tambahkan bidang baru ke model.
• Migrasikan perubahan skema bidang baru ke database.

Pendekatan ini EF Core memungkinkan proses pengembangan yang lebih tangkas. Pengembang bekerja pada model data aplikasi secara langsung saat skema database dibuat dan kemudian disinkronkan, semua tanpa pengembang harus beralih konteks ke dan dari alat manajemen database. Untuk gambaran umum Entity Framework Core dan manfaatnya, lihat Entity Framework Core.

Menggunakan Kode EF untuk membuat dan melacak database secara otomatis:

• __EFMigrationsHistory Menambahkan tabel ke database untuk melacak apakah skema database sinkron dengan kelas model yang dihasilkannya.
• Memberikan pengecualian jika kelas model tidak sinkron dengan database.

Verifikasi otomatis bahwa skema dan model sinkron memudahkan untuk menemukan masalah kode database yang tidak konsisten.

Menambahkan Properti Peringkat ke Model Film

1. Models/Movie.cs Buka file dan tambahkan Rating properti:

   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. Edit Pages/Movies/Index.cshtml, dan tambahkan Rating bidang:

   @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. Perbarui halaman berikut dengan Rating bidang:

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

Aplikasi tidak akan berfungsi sampai database diperbarui untuk menyertakan bidang baru. Menjalankan aplikasi tanpa pembaruan ke database melempar :SqlException

SqlException: Invalid column name 'Rating'.

Pengecualian SqlException disebabkan oleh kelas model Film yang diperbarui berbeda dari skema tabel Film database. Tidak ada Rating kolom dalam tabel database.

Ada beberapa pendekatan untuk mengatasi kesalahan:

1. Minta Kerangka Kerja Entitas secara otomatis menghilangkan dan membuat ulang database menggunakan skema kelas model baru. Pendekatan ini nyaman di awal siklus pengembangan, memungkinkan pengembang untuk dengan cepat mengembangkan model dan skema database bersama-sama. Kelemahannya adalah bahwa data yang ada dalam database hilang. Jangan gunakan pendekatan ini pada database produksi! Menghilangkan database pada perubahan skema dan menggunakan penginisialisasi untuk secara otomatis menyemai database dengan data pengujian sering kali merupakan cara produktif untuk mengembangkan aplikasi.
2. Ubah skema database yang ada secara eksplisit sehingga cocok dengan kelas model. Keuntungan dari pendekatan ini adalah menyimpan data. Buat perubahan ini secara manual atau dengan membuat skrip perubahan database.
3. Gunakan EF Core Migrasi untuk memperbarui skema database.

Untuk tutorial ini, gunakan EF Core Migrasi.

SeedData Perbarui kelas sehingga memberikan nilai untuk kolom baru. Perubahan sampel ditunjukkan di bawah ini, tetapi buat perubahan ini untuk setiap new Movie blok.

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

Lihat file SeedData.cs yang telah selesai.

Membangun aplikasi

Visual Studio

Tekan Ctrl+Shift+B

Visual Studio Code

Dari menu Tampilan, pilih Terminal dan masukkan perintah berikut:

dotnet build

Visual Studio

Menambahkan migrasi untuk bidang peringkat

1. Dari menu Alat , pilih NuGet Package Manager > Package Manager Console.

2. Di Package Manager Console (PMC), masukkan perintah berikut:

   Add-Migration Rating
   

Perintah Add-Migration memberi tahu kerangka kerja untuk:

• Bandingkan Movie model dengan Movie skema database.
• Buat kode untuk memigrasikan skema database ke model baru.

Nama "Peringkat" bersifat arbitrer dan digunakan untuk memberi nama file migrasi. Sangat membantu untuk menggunakan nama yang bermakna untuk file migrasi.

2. Di PMC, masukkan perintah berikut:

   Update-Database
   

Perintah Update-Database memberi tahu kerangka kerja untuk menerapkan perubahan skema ke database dan untuk mempertahankan data yang ada.

Hapus semua rekaman dalam database, penginisialisasi akan menyemai database dan menyertakan Rating bidang . Menghapus dapat dilakukan dengan tautan penghapusan di browser atau dari Sql Server Object Explorer (SSOX).

Opsi lain adalah menghapus database dan menggunakan migrasi untuk membuat ulang database. Untuk menghapus database di SSOX:

1. Pilih database di SSOX.

2. Klik kanan pada database, dan pilih Hapus.

3. Centang Tutup koneksi yang sudah ada.

4. Pilih OK.

5. Di PMC, perbarui database:

   Update-Database
   

Visual Studio Code

Menambahkan migrasi untuk peringkat

Gunakan perintah berikut untuk menambahkan migrasi untuk bidang peringkat:

dotnet ef migrations add rating
dotnet ef database update

Perintah dotnet ef migrations add rating memberi tahu kerangka kerja untuk:

• Bandingkan Movie model dengan Movie skema database.
• Buat kode untuk memigrasikan skema database ke model baru.

Nama rating ini segan-segan dan digunakan untuk memberi nama file migrasi. Sangat membantu untuk menggunakan nama yang bermakna untuk file migrasi.

Perintah dotnet ef database update memberi tahu kerangka kerja untuk menerapkan perubahan skema ke database dan untuk mempertahankan data yang ada.

Hapus semua rekaman dalam database, penginisialisasi akan menyemai database dan menyertakan Rating bidang .

Opsional: Menghilangkan dan membuat ulang database untuk penyedia lain

Lewati bagian ini jika Anda berhasil memigrasikan database.

Dalam tutorial ini, fitur migrasi Entity Framework Core digunakan jika memungkinkan. Migrasi memperbarui skema database agar sesuai dengan perubahan dalam model data. Namun, migrasi hanya dapat melakukan jenis perubahan yang EF Core didukung penyedia, dan beberapa kemampuan penyedia terbatas. Misalnya, menambahkan kolom mungkin didukung, tetapi menghapus atau mengubah kolom tidak. Jika migrasi dibuat untuk menghapus atau mengubah kolom, ef migrations add perintah berhasil tetapi ef database update perintah gagal. Karena keterbatasan ini, Anda dapat menghilangkan dan membuat ulang database.

Solusi untuk batasan adalah menulis kode migrasi secara manual untuk melakukan pembangunan ulang tabel saat sesuatu dalam tabel berubah. Pembangunan ulang tabel melibatkan:

• Membuat tabel baru.
• Menyalin data dari tabel lama ke tabel baru.
• Menjatuhkan tabel lama.
• Mengganti nama tabel baru.

Untuk informasi selengkapnya, lihat sumber daya berikut:

• Batasan Penyedia Database SQLite EF Core
• Menyesuaikan kode migrasi
• Seeding data
• Pernyataan SQLite ALTER TABLE

1. Menghapus folder migrasi.

2. Gunakan perintah berikut untuk membuat ulang database.

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

Jalankan aplikasi dan verifikasi bahwa Anda dapat membuat, mengedit, dan menampilkan film dengan Rating bidang. Jika database tidak seeded, atur titik henti dalam SeedData.Initialize metode .

Langkah selanjutnya

Sebelumnya: Tambahkan PencarianBerikutnya: Tambahkan Validasi