Parte 7, aggiungere un nuovo campo a una Razor pagina in ASP.NET Core

Di Rick Anderson

In questa sezione vengono usate le Migrazioni Code First di Entity Framework per:

• Aggiungere un nuovo campo al modello.
• Eseguire la migrazione nel database della modifica al nuovo schema del campo.

Quando si usa Entity Framework Code First per creare e tenere traccia automaticamente di un database, Code First:

• Aggiunge una __EFMigrationsHistory tabella al database per rilevare se lo schema del database è sincronizzato con le classi del modello da cui è stato generato.
• Genera un'eccezione se le classi del modello non sono sincronizzate con il database.

La verifica automatica che lo schema e il modello sono sincronizzati semplifica l'individuazione di problemi di codice del database incoerenti.

Aggiunta di una proprietà Rating al modello Movie

1. Aprire il Models/Movie.cs file e aggiungere una Rating proprietà:

   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. Modificare Pages/Movies/Index.cshtmle aggiungere un Rating campo:

   @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. Aggiornare le pagine seguenti con un Rating campo:

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

L'app non funzionerà finché il database non viene aggiornato per includere il nuovo campo. L'esecuzione dell'app senza un aggiornamento al database genera un'eccezione SqlException:

SqlException: Invalid column name 'Rating'.

L'eccezione SqlException è causata dalla classe del modello Movie aggiornata diversa dallo schema della tabella Movie del database. Nella tabella di database non è presente alcuna Rating colonna.

Per correggere questo errore, esistono alcuni approcci:

1. Fare in modo che Entity Framework elimini e crei di nuovo automaticamente il database usando il nuovo schema di classi del modello. Questo approccio è utile nelle prime fasi del ciclo di sviluppo, consentendo agli sviluppatori di evolvere rapidamente il modello e lo schema del database insieme. Lo svantaggio è che i dati esistenti nel database andranno persi. Non usare questo approccio in un database di produzione. L'eliminazione del database sulle modifiche dello schema e l'uso di un inizializzatore per eseguire automaticamente il seeding del database con i dati di test è spesso un modo produttivo per sviluppare un'app.
2. Modificare esplicitamente lo schema del database esistente in modo che corrisponda alle classi del modello. Il vantaggio di questo approccio consiste nel mantenere i dati. Apportare questa modifica manualmente o creando uno script di modifica del database.
3. Usare Migrazioni Code First per aggiornare lo schema del database.

Per questa esercitazione usare Migrazioni Code First.

Aggiornare la classe SeedData in modo che fornisca un valore per la nuova colonna. Di seguito è illustrata una modifica di esempio, ma apportare questa modifica per ogni new Movie blocco.

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

Vedere il file SeedData.cs completato.

Creare l'app

Visual Studio

Premere CTRL+MAIUSC+B

Visual Studio Code

Dal menu Visualizza selezionare Terminale e immettere il comando seguente:

dotnet build

Visual Studio per Mac

Premere ⌘+B

Visual Studio

Aggiungere una migrazione per il campo Rating

1. Scegliere NuGet Gestione pacchetti > console Gestione pacchetti dal menu Strumenti.

2. Nella Console di Gestione pacchetti immettere i comandi seguenti:

   Add-Migration Rating
   Update-Database
   

Il comando Add-Migration indica al framework di:

• Confrontare il Movie modello con lo schema del Movie database.
• Creare il codice per eseguire la migrazione dello schema del database al nuovo modello.

Il nome "Rating" è arbitrario e viene usato per denominare il file di migrazione. È consigliabile usare un nome significativo per il file di migrazione.

Il Update-Database comando indica al framework di applicare le modifiche dello schema al database e di conservare i dati esistenti.

Eliminare tutti i record nel database, l'inizializzatore eseguirà il seeding del database e includerà il Rating campo . L'eliminazione può essere eseguita con i collegamenti di eliminazione nel browser o da Sql Server Esplora oggetti (SSOX).

Un'altra opzione è quella di eliminare il database e usare le migrazioni per ricreare il database. Per eliminare il database da SSOX:

1. Selezionare il database in SSOX.

2. Fare clic con il pulsante destro del mouse sul database e scegliere Elimina.

3. Selezionare Chiudi connessioni esistenti.

4. Seleziona OK.

5. Nella Console di Gestione pacchetti aggiornare il database:

   Update-Database
   

Visual Studio Code/Visual Studio per Mac

Aggiungere una migrazione per la classificazione

Usare i comandi seguenti per aggiungere una migrazione per il campo classificazione:

dotnet ef migrations add rating
dotnet ef database update

Il comando dotnet-ef migrations add rating indica al framework di:

• Confrontare il Movie modello con lo schema del Movie database.
• Creare il codice per eseguire la migrazione dello schema del database al nuovo modello.

Il nome rating è arbitrario e viene usato per denominare il file di migrazione. È consigliabile usare un nome significativo per il file di migrazione.

Il dotnet-ef database update comando indica al framework di applicare le modifiche dello schema al database e di conservare i dati esistenti.

Eliminare tutti i record nel database, l'inizializzatore eseguirà il seeding del database e includerà il Rating campo .

Facoltativo: eliminare e ricreare il database per altri provider

Ignorare questa sezione se è stata eseguita correttamente la migrazione del database.

In questa esercitazione, le funzionalità delle migrazioni di Entity Framework Core vengono usate quando possibile. Le migrazioni aggiornano lo schema del database in base alle modifiche nel modello di dati. Tuttavia, le migrazioni possono eseguire solo i tipi di modifiche supportate dal EF Core provider e alcune funzionalità del provider sono limitate. Ad esempio, l'aggiunta di una colonna può essere supportata, ma la rimozione o la modifica di una colonna non è . Se si crea una migrazione per rimuovere o modificare una colonna, il comando ef migrations add ha esito positivo, ma il comando ef database update ha esito negativo. A causa di queste limitazioni, è possibile eliminare e ricreare il database.

La soluzione alternativa per le limitazioni consiste nel scrivere manualmente il codice delle migrazioni per eseguire una ricompilazione di una tabella quando viene modificato un elemento nella tabella. La ricompilazione della tabella comporta:

• Creazione di una nuova tabella.
• Copia dei dati dalla vecchia tabella alla nuova tabella.
• Eliminazione della tabella precedente.
• Ridenominazione della nuova tabella.

Per ulteriori informazioni, vedi le seguenti risorse:

• Limitazioni del provider di database SQLite EF Core
• Personalizzare il codice di migrazione
• Seeding dei dati
• Istruzione ALTER TABLE di SQLite

1. Eliminare la cartella della migrazione.

2. Usare i comandi seguenti per ricreare il database.

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

Eseguire l'app e verificare che sia possibile creare, modificare e visualizzare film con un Rating campo. Se il database non è inizializzato, impostare un punto di interruzione nel metodo SeedData.Initialize.

Passaggi successivi

Precedente: Aggiungi ricercasuccessiva: Aggiungi convalida