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:

• Adicione um novo campo ao modelo.
• Migre o novo campo para o banco de dados.

Quando o Entity Framework (EF) é usado para criar automaticamente um banco de dados a partir de classes de modelo:

• Uma tabela é adicionada ao banco de dados para controlar o esquema do banco de dados.
• Verifica-se que o banco de dados está em sincronia com as classes de modelo a partir das quais foi gerado. Se eles não estiverem sincronizados, EF lançará uma exceção. Isso facilita a localização de problemas inconsistentes de banco de dados/código.

Adicionar uma propriedade de classificação ao modelo de filme

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

Crie o aplicativo

Estúdio Visual

Pressione Ctrl+Shift+B

Código do Visual Studio

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

dotnet build

Como você adicionou um novo campo à Movie classe, precisa atualizar a lista de vinculação de propriedades para que essa nova propriedade seja incluída. No MoviesController.cs, atualize o atributo [Bind] para os 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 Rating propriedade na visualização do navegador.

Edite o /Views/Movies/Index.cshtml arquivo e adicione um Rating campo:

<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.

Estúdio Visual

Você pode copiar/colar o "grupo de formulários" anterior e deixar o intelliSense ajudá-lo a atualizar os campos. O IntelliSense funciona com Tag Helpers.

Código do Visual Studio

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

Atualize a classe SeedData para que ela forneça um valor para a nova coluna. Um exemplo de alteração é mostrado abaixo, mas você desejará fazer essa alteração para 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 banco de dados seja atualizado para incluir o novo campo. Se for 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á coluna Rating na tabela do banco de dados.)

Existem algumas abordagens para resolver o erro:

1. Faça com que o Entity Framework solte 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 desenvolvimento ativo em um banco de dados de teste; Ele permite que você evolua rapidamente o modelo e o esquema de banco de dados juntos. A desvantagem, porém, é que você perde dados existentes no banco de dados — portanto, não quer usar essa abordagem em um banco de dados de produção! Usar um inicializador para semear automaticamente um banco de dados com dados de teste geralmente é uma maneira produtiva de desenvolver um aplicativo. Esta é uma boa abordagem para o desenvolvimento inicial e ao usar 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 seus dados. Você pode fazer essa alteração manualmente ou criando um script de alteração de banco de dados.

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

Para este tutorial, as migrações do Entity Framework são usadas.

Estúdio Visual

No menu Ferramentas, selecione Gestor de Pacotes NuGet > Consola do Gestor de Pacotes.

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

Add-Migration Rating

O Add-Migration comando diz à estrutura de migração para examinar o modelo atual Movie com o esquema de banco de dados atual Movie e criar o código necessário para migrar o banco de dados 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 todos os registros no banco de dados forem excluídos, o método initialize semeará o banco de dados e incluirá o Rating campo.

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.

Código do Visual Studio

Observação

Para este tutorial, você usa o recurso migrações do Entity Framework Core sempre que possível. As migrações atualizam o esquema do 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 de EF Core suporta, e os recursos do provedor SQLite são limitados. Por exemplo, a adição de uma coluna é suportada, mas a remoção ou alteração de uma coluna não é suportada. Se uma migração for criada para remover ou alterar uma coluna, o comando ef migrations add será bem-sucedido, mas o comando ef database update falhará. Devido a essas limitações, este tutorial não usa migrações para alterações de esquema SQLite. Em vez disso, quando o esquema muda, elimina-se e recria-se a base de dados.

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

• Criação de uma nova tabela.
• Copiar dados da tabela antiga para a nova tabela.
• Eliminar a mesa velha.
• Renomeando a nova tabela.

Para obter mais informações, consulte os seguintes recursos:

• Limitações do provedor de banco de dados SQLite EF Core
• Personalizar o código de migração
• Semeadura de dados
• instrução SQLite ALTER TABLE

Exclua a pasta Migrations 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.

AnteriorPróximo