Bölüm 7, ASP.NET Core'da sayfaya yeni alan Razor ekleme

Gönderen Rick Anderson

Bu bölümde Entity Framework Kodu İlk Geçişler şunları yapmak için kullanılır:

• Modele yeni bir alan ekleyin.
• Yeni alan şeması değişikliğini veritabanına geçirin.

Otomatik olarak veritabanı oluşturmak ve izlemek için EF Code First kullanırken Code First:

• Veritabanının şemasının oluşturulduğu model sınıflarıyla eşitlenip eşitlenmediğini izlemek için veritabanına bir __EFMigrationsHistory tablo ekler.
• Model sınıfları veritabanıyla eşitlenmemişse bir özel durum oluşturur.

Şema ve modelin eşitlenmiş olduğunu otomatik doğrulama, tutarsız veritabanı kodu sorunlarını bulmayı kolaylaştırır.

Film Modeline Derecelendirme Özelliği Ekleme

1. Models/Movie.cs Dosyayı açın ve bir Rating özellik ekleyin:

   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. öğesini düzenleyin Pages/Movies/Index.cshtmlve bir Rating alan ekleyin:

   @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. Aşağıdaki sayfaları bir Rating alanla güncelleştirin:

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

Veritabanı yeni alanı içerecek şekilde güncelleştirilene kadar uygulama çalışmaz. Veritabanını güncelleştirmeden uygulamayı çalıştırmak bir SqlExceptionoluşturur:

SqlException: Invalid column name 'Rating'.

Özel SqlException durum, güncelleştirilmiş Movie model sınıfının veritabanının Movie tablosunun şemasından farklı olmasından kaynaklanır. Veritabanı tablosunda sütun yok Rating .

Hatayı çözmek için birkaç yaklaşım vardır:

1. Entity Framework'ün yeni model sınıfı şemasını kullanarak veritabanını otomatik olarak bırakmasını ve yeniden oluşturmasını sağlayın. Bu yaklaşım geliştirme döngüsünün erken dönemlerinde kullanışlıdır ve geliştiricilerin model ve veritabanı şemasını birlikte hızla geliştirmesine olanak tanır. Bunun dezavantajı, veritabanındaki mevcut verilerin kaybolmasıdır. Bu yaklaşımı üretim veritabanında kullanmayın! Veritabanını şema değişikliklerine bırakmak ve test verileriyle veritabanını otomatik olarak görmek için başlatıcı kullanmak genellikle uygulama geliştirmenin üretken bir yoludur.
2. Var olan veritabanının şemasını model sınıflarının eşleşmesi için açıkça değiştirin. Bu yaklaşımın avantajı, verileri korumaktır. Bu değişikliği el ile veya veritabanı değişiklik betiği oluşturarak yapın.
3. Veritabanı şemasını güncelleştirmek için Code First Migrations'ı kullanın.

Bu öğretici için Code First Migrations'ı kullanın.

sınıfını SeedData yeni sütun için bir değer sağlayacak şekilde güncelleştirin. Aşağıda örnek bir değişiklik gösterilir, ancak her new Movie blok için bu değişikliği yapın.

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

Tamamlanmış SeedData.cs dosyasına bakın.

Uygulamayı oluşturma

Visual Studio

Ctrl+Shift B tuşlarına basın +

Visual Studio Code

Görünüm menüsünden Terminal'i seçin ve aşağıdaki komutu girin:

dotnet build

Mac için Visual Studio

⌘+B tuşlarına basın

Visual Studio

Derecelendirme alanı için geçiş ekleme

1. Araçlar menüsünde NuGet Paket Yöneticisi Paket Yöneticisi > Konsolu'nu seçin.

2. PMC'de aşağıdaki komutları girin:

   Add-Migration Rating
   Update-Database
   

komutu, Add-Migration çerçeveye şunu söyler:

• Movie Modeli veritabanı şemasıyla Movie karşılaştırın.
• Veritabanı şemasını yeni modele geçirmek için kod oluşturun.

"Derecelendirme" adı rastgeledir ve geçiş dosyasını adlandırmak için kullanılır. Geçiş dosyası için anlamlı bir ad kullanmak yararlı olur.

komutu, Update-Database çerçeveye şema değişikliklerini veritabanına uygulamasını ve mevcut verileri korumasını söyler.

Veritabanındaki tüm kayıtları sildiğinizde, başlatıcı veritabanının tohumunu oluşturur ve alanını ekler Rating . Silme işlemi, tarayıcıdaki veya Sql Server Nesne Gezgini'ndeki (SSOX) silme bağlantıları ile yapılabilir.

Bir diğer seçenek de veritabanını silmek ve veritabanını yeniden oluşturmak için geçişleri kullanmaktır. SSOX'ta veritabanını silmek için:

1. SSOX'ta veritabanını seçin.

2. Veritabanına sağ tıklayın ve Sil'i seçin.

3. Var olan bağlantıları kapat'ı işaretleyin.

4. Tamam'ı seçin.

5. PMC'de veritabanını güncelleştirin:

   Update-Database
   

Visual Studio Code / Mac için Visual Studio

Derecelendirme için geçiş ekleme

Derecelendirme alanına geçiş eklemek için aşağıdaki komutları kullanın:

dotnet ef migrations add rating
dotnet ef database update

komutu, dotnet ef migrations add rating çerçeveye şunu söyler:

• Movie Modeli veritabanı şemasıyla Movie karşılaştırın.
• Veritabanı şemasını yeni modele geçirmek için kod oluşturun.

Ad rating rastgeledir ve geçiş dosyasını adlandırmak için kullanılır. Geçiş dosyası için anlamlı bir ad kullanmak yararlı olur.

komutu, dotnet ef database update çerçeveye şema değişikliklerini veritabanına uygulamasını ve mevcut verileri korumasını söyler.

Veritabanındaki tüm kayıtları sildiğinizde, başlatıcı veritabanının tohumunu oluşturur ve alanını ekler Rating .

İsteğe bağlı: Diğer sağlayıcılar için veritabanını bırakma ve yeniden oluşturma

Veritabanını başarıyla geçirdiyseniz bu bölümü atlayın.

Bu öğreticide, mümkün olduğunda Entity Framework Core geçişleri özellikleri kullanılır. Geçişler veritabanı şemasını veri modelindeki değişikliklerle eşleşecek şekilde güncelleştirir. Ancak geçişler yalnızca sağlayıcının EF Core desteklediği türde değişiklikler yapabilir ve bazı sağlayıcının özellikleri sınırlıdır. Örneğin, sütun ekleme desteklenebilir, ancak sütunu kaldırmak veya değiştirmek desteklenmez. Bir sütunu kaldırmak veya değiştirmek için bir geçiş oluşturulursa, ef migrations add komut başarılı olur ancak ef database update komut başarısız olur. Bu sınırlamalar nedeniyle veritabanını bırakabilir ve yeniden oluşturabilirsiniz.

Sınırlamalar için geçici çözüm, tablodaki bir şey değiştiğinde tablo yeniden derlemesi gerçekleştirmek için geçiş kodunu el ile yazmaktır. Tablo yeniden derlemesi şunları içerir:

• Yeni tablo oluşturma.
• Eski tablodan yeni tabloya veri kopyalama.
• Eski masayı bırak.
• Yeni tablo yeniden adlandırıyor.

Daha fazla bilgi edinmek için aşağıdaki kaynaklara bakın:

• SQLite EF Core Veritabanı Sağlayıcısı Sınırlamaları
• Geçiş kodunu özelleştirme
• Veri tohumlama
• SQLite ALTER TABLE deyimi

1. Geçiş klasörünü silin.

2. Veritabanını yeniden oluşturmak için aşağıdaki komutları kullanın.

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

Uygulamayı çalıştırın ve bir Rating alanla film oluşturabildiğinizi, düzenleyebildiğinizi ve görüntüleyebildiğinizi doğrulayın. Veritabanı tohumlanmamışsa yönteminde SeedData.Initialize bir kesme noktası ayarlayın.

Sonraki adımlar

Önceki: Sonraki AramaEkle: Doğrulama Ekle