Parte 8. Adición de un nuevo campo a una aplicación de ASP.NET Core MVC

Por Rick Anderson

En esta sección, Migraciones de Entity Framework se usa para:

• Agregar un campo nuevo al modelo.
• Migrar el nuevo campo a la base de datos.

Cuando Entity Framework (EF) se usa para crear automáticamente una base de datos a partir de clases de modelo:

• Se agrega una tabla a la base de datos para realizar un seguimiento del esquema de la base de datos.
• La base de datos se comprueba para sincronizarse con las clases del modelo desde las que se generó. Si no está sincronizado, EF produce una excepción. Esto facilita la detección de problemas de código o base de datos incoherentes.

Adición de una propiedad de clasificación al modelo Movie

Agregue una propiedad Rating a Models/Movie.cs:

using System;
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace MvcMovie.Models;

public class Movie
{
    public int Id { get; set; }
    public string? Title { get; set; }

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

Compilar la aplicación

Visual Studio

Presione Ctrl+Mayús+B

Visual Studio Code

En el menú Ver, seleccione Terminal y escriba el siguiente comando:

dotnet build

Dado que ha agregado un campo nuevo a la clase Movie, debe actualizar la lista de enlaces de propiedades para que se incluya esta propiedad nueva. En MoviesController.cs, actualice el atributo [Bind] de los métodos de acción Create y Edit para incluir la propiedad Rating:

[Bind("Id,Title,ReleaseDate,Genre,Price,Rating")]

Actualice las plantillas de vista para mostrar, crear y editar la nueva propiedad Rating en la vista del explorador.

Edite el archivo /Views/Movies/Index.cshtml y agregue un campo Rating:

<table class="table">
    <thead>
        <tr>
            <th>
                @Html.DisplayNameFor(model => model.Movies![0].Title)
            </th>
            <th>
                @Html.DisplayNameFor(model => model.Movies![0].ReleaseDate)
            </th>
            <th>
                @Html.DisplayNameFor(model => model.Movies![0].Genre)
            </th>
            <th>
                @Html.DisplayNameFor(model => model.Movies![0].Price)
            </th>
            <th>
                @Html.DisplayNameFor(model => model.Movies![0].Rating)
            </th>
            <th></th>
        </tr>
    </thead>
    <tbody>
        @foreach (var item in Model.Movies!)
        {
            <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-action="Edit" asp-route-id="@item.Id">Edit</a> |
                    <a asp-action="Details" asp-route-id="@item.Id">Details</a> |
                    <a asp-action="Delete" asp-route-id="@item.Id">Delete</a>
                </td>
            </tr>
        }
    </tbody>
</table>

Actualice /Views/Movies/Create.cshtml con un campo Rating.

Visual Studio

Puede copiar o pegar el elemento "form group" anterior y permitir que IntelliSense le ayude a actualizar los campos. IntelliSense funciona con asistentes de etiquetas.

Visual Studio Code

Agregue la propiedad Rating al resto de plantillas de vista Create.cshtml, Delete.cshtml, Details.cshtml y Edit.cshtml.

Actualice la clase SeedData para que proporcione un valor para la nueva columna. A continuación se muestra un cambio de ejemplo, aunque es conveniente realizarlo con cada new Movie.

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

La aplicación no funciona hasta que la base de datos se actualiza para incluir el nuevo campo. Si se ejecuta ahora, se produce la siguiente SqlException:

SqlException: Invalid column name 'Rating'.

Este error se produce porque la clase del modelo Movie actualizada es diferente a la del esquema de la tabla Movie de la base de datos existente. (No hay ninguna columna Rating en la tabla de la base de datos).

Este error se puede resolver de varias maneras:

1. Haga que Entity Framework quite de forma automática la base de datos y la vuelva a crear basándose en el nuevo esquema de la clase del modelo. Este enfoque resulta muy conveniente al principio del ciclo de desarrollo cuando se realiza el desarrollo activo en una base de datos de prueba; permite desarrollar rápidamente el esquema del modelo y la base de datos juntos. La desventaja es que se pierden los datos existentes en la base de datos, así que no use este enfoque en una base de datos de producción. Usar un inicializador para inicializar automáticamente una base de datos con datos de prueba suele ser una manera productiva de desarrollar una aplicación. Se trata de un buen enfoque para el desarrollo inicial y cuando se usa SQLite.

2. Modifique explícitamente el esquema de la base de datos existente para que coincida con las clases del modelo. La ventaja de este enfoque es que se conservan los datos. Puede realizar este cambio de forma manual o mediante la creación de un script de cambio de base de datos.

3. Use Migraciones de Entity Framework para actualizar el esquema de la base de datos.

En este tutorial, se usa Migraciones de Entity Framework.

Visual Studio

En el menú Herramientas, seleccione Administrador de paquetes NuGet >Consola del Administrador de paquetes.

En la Consola del Administrador de paquetes, escriba el siguiente comando:

Add-Migration Rating

El comando Add-Migration indica el marco de trabajo de migración para examinar el modelo Movie actual con el esquema de base de datos Movie actual y para crear el código con el que se migrará la base de datos al nuevo modelo.

El nombre "Rating" es arbitrario y se usa para asignar nombre al archivo de migración. Resulta útil emplear un nombre descriptivo para el archivo de migración.

Si se eliminan todos los registros de la base de datos, el método de inicialización inicializa la base de datos e incluye el campo Rating.

En la Consola del Administrador de paquetes, escriba el siguiente comando:

Update-Database

El comando Update-Database ejecuta el método Up en las migraciones que no se aplicaron.

Visual Studio Code

Nota:

Para este tutorial usará la característica de las migraciones de Entity Framework Core siempre que sea posible. Las migraciones actualizan el esquema de la base de datos para que coincida con los cambios en el modelo de datos. Aun así, las migraciones solo pueden realizar los tipos de cambios que admite el proveedor de EF Core; las funcionalidades del proveedor de SQLite son limitadas. Por ejemplo, se permite agregar una columna, pero no eliminarla ni cambiarla. Si se crea una migración para quitar o cambiar una columna, el comando ef migrations add se ejecuta correctamente, pero el comando ef database update produce un error. Debido a estas limitaciones, este tutorial no usa las migraciones para realizar cambios en el esquema de SQLite. En su lugar, cuando cambie el esquema, desconectará la base de datos y volverá a crearla.

La solución alternativa para las limitaciones de SQLite consiste en escribir de forma manual el código de migraciones para llevar a cabo una recompilación de la tabla cuando cambie algún elemento de esta. La recompilación de una tabla implica lo siguiente:

• Crear una tabla.
• Copiar datos de la tabla antigua a la nueva tabla.
• Eliminar la tabla anterior.
• Cambiar el nombre de la tabla nueva.

Para obtener más información, vea los siguientes recursos:

• Limitaciones del proveedor de base de datos SQLite de EF Core
• Personalización del código de migración
• Propagación de los datos
• Instrucción ALTER TABLE de SQLite

Elimine la carpeta Migraciones y el archivo de base de datos y, a continuación, ejecute los siguientes comandos de la CLI de .NET:

dotnet ef migrations add InitialCreate

dotnet ef database update

Para más información, consulte: Restablecimiento de todas las migraciones.

Ejecute la aplicación y compruebe que puede crear, editar o mostrar vídeos con un campo Rating.

AnteriorSiguiente