Parte 8, adicionar um novo campo a um aplicativo ASP.NET Core MVC

Por Rick Anderson

Nesta seção, as Migrações do Entity Framework são usadas para:

• Adicionar um novo campo ao modelo.
• Migrar o novo campo para o banco de dados.

Quando o EF (Entity Framework) é usado para criar automaticamente um banco de dados com base nas classes de modelo:

• Uma tabela é adicionada ao banco de dados para rastrear o esquema do banco de dados.
• O banco de dados foi verificado como estando em sincronia com as classes de modelo com base nas quais ele foi gerado. Se ele não estiver sincronizado, o EF gerará uma exceção. Isso facilita a descoberta de problemas de código/banco de dados inconsistente.

Adicionar uma Propriedade de Classificação ao Modelo de Filme

Adiciona uma propriedade 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; }
}

Criar o aplicativo

Visual Studio

Pressione CTRL+SHIFT+B

Visual Studio Code

No menu Exibir, selecione Terminal e insira o seguinte comando:

dotnet build

Como adicionou um novo campo à classe Movie, você também precisará atualizar a lista de permissões de associação para que essa nova propriedade seja incluída. Em MoviesController.cs, atualize o atributo [Bind] dos métodos de ação Create e Edit para incluir a propriedade Rating:

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

Atualize os modelos de exibição para exibir, criar e editar a nova propriedade Rating na exibição do navegador.

Edite o arquivo /Views/Movies/Index.cshtml e adicione um 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>

Atualize o /Views/Movies/Create.cshtml com um campo Rating.

Visual Studio

Copie/cole o “grupo de formulário” anterior e permita que o IntelliSense ajude você a atualizar os campos. O IntelliSense funciona com os Auxiliares de Marcação.

Visual Studio Code

Adicione a propriedade Rating aos modelos de exibição Create.cshtml, Delete.cshtml, Details.cshtml e Edit.cshtml restantes.

Atualize a classe SeedData para que ela forneça um valor para a nova coluna. Uma alteração de amostra é mostrada abaixo, mas é recomendável fazer essa alteração em cada new Movie.

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

O aplicativo não funcionará até que o BD seja atualizado para incluir o novo campo. Se ele tiver sido executado agora, o seguinte SqlException será gerado:

SqlException: Invalid column name 'Rating'.

Este erro ocorre porque a classe de modelo Movie atualizada é diferente do esquema da tabela Movie do banco de dados existente. (Não há nenhuma coluna Rating na tabela de banco de dados.)

Existem algumas abordagens para resolver o erro:

1. Faça com que o Entity Framework remova automaticamente e recrie o banco de dados com base no novo esquema de classe de modelo. Essa abordagem é muito conveniente no início do ciclo de desenvolvimento, quando você está fazendo o desenvolvimento ativo em um banco de dados de teste. Ela permite que você desenvolva rapidamente o modelo e o esquema de banco de dados juntos. No entanto, a desvantagem é que você perde os dados existentes no banco de dados – portanto, você não deseja usar essa abordagem em um banco de dados de produção! Muitas vezes, o uso de um inicializador para propagar um banco de dados com os dados de teste automaticamente é uma maneira produtiva de desenvolver um aplicativo. Isso é uma boa abordagem para o desenvolvimento inicial e ao usar o SQLite.

2. Modifique explicitamente o esquema do banco de dados existente para que ele corresponda às classes de modelo. A vantagem dessa abordagem é que você mantém os dados. Faça essa alteração manualmente ou criando um script de alteração de banco de dados.

3. Use Migrações do Entity Framework para atualizar o esquema de banco de dados.

Neste tutorial, as Migrações do Entity Framework são usadas.

Visual Studio

No menu Ferramentas, selecione Gerenciador de Pacotes NuGet > Console do Gerenciador de Pacotes.

No Console do Gerenciador de Pacotes, digite o seguinte comando:

Add-Migration Rating

O comando Add-Migration informa a estrutura de migração para examinar o atual modelo Movie com o atual esquema de BD Movie e criar o código necessário para migrar o BD para o novo modelo.

O nome “Classificação” é arbitrário e é usado para nomear o arquivo de migração. É útil usar um nome significativo para o arquivo de migração.

Se você excluir todos os registros do BD, o método de inicialização propagará o BD e incluirá o campo Rating.

No Console do Gerenciador de Pacotes, digite o seguinte comando:

Update-Database

O comando Update-Database executa o método Up em migrações que não foram aplicadas.

Visual Studio Code

Observação

Para este tutorial, use o recurso de migrações do Entity Framework Core sempre que possível. As migrações atualizam o esquema de banco de dados para corresponder às alterações no modelo de dados. No entanto, as migrações só podem fazer os tipos de alterações que o provedor do EF Core oferece suporte. Os recursos do provedor SQLite são limitados. Por exemplo, há suporte para adicionar uma coluna, mas não há suporte para a remoção ou a alteração de uma coluna. Se uma migração é criada para remover ou alterar uma coluna, o comando ef migrations add tem êxito, mas o comando ef database update falha. Devido a essas limitações, este tutorial não usa as migrações para alterações de esquema do SQLite. Em vez disso, quando o esquema for alterado, você deverá remover e recriar o banco de dados.

A solução alternativa para as limitações do SQLite é escrever manualmente o código das migrações para executar uma recompilação de tabela quando algo na tabela for alterado. Uma recompilação de tabela envolve:

• Criar uma nova tabela.
• Copiar dados da tabela antiga para a nova tabela.
• Remover a tabela antiga.
• Renomear a nova tabela.

Para saber mais, consulte os recursos a seguir:

• Limitações do Provedor de Banco de Dados SQLite EF Core
• Personalizar o código de migração
• Propagação de dados
• Instrução SQLite ALTER TABLE

Exclua a pasta Migrações e o arquivo de banco de dados e execute os seguintes comandos da CLI do .NET:

dotnet ef migrations add InitialCreate

dotnet ef database update

Para obter mais informações, consulte Redefinindo todas as migrações.

Execute o aplicativo e verifique se você pode criar, editar e exibir filmes com um campo Rating.

AnteriorAvançar