Parte 7, adicionar um novo campo a um Razor Pages no ASP.NET Core

Por Rick Anderson

Nesta seção , o Entity Framework Core (EF Core) é usado para definir o esquema de banco de dados com base na classe de modelo do aplicativo:

• Adicionar um novo campo ao modelo.
• Migrar a nova alteração de esquema de campo para o banco de dados.

A EF Core abordagem permite um processo de desenvolvimento mais ágil. O desenvolvedor trabalha diretamente no modelo de dados do aplicativo enquanto o esquema de banco de dados é criado e sincronizado, tudo sem que o desenvolvedor precise alternar contextos de e para uma ferramenta de gerenciamento de dados. Para obter uma visão geral do Entity Framework Core e seus benefícios, consulte Entity Framework Core.

Usando o EF Code para criar e acompanhar automaticamente um banco de dados:

• Adiciona uma tabela __EFMigrationsHistory ao banco de dados para acompanhar se o esquema do banco de dados está sincronizado com as classes de modelo das quais ele foi gerado.
• Gera uma exceção se as classes de modelo não estiverem sincronizadas com o banco de dados.

A verificação automática de que o esquema e o modelo estão sincronizados facilita a localização de problemas de código de banco de dados inconsistentes.

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

1. Abra o arquivo Models/Movie.cs e adicione uma propriedade Rating:

   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. Edite Pages/Movies/Index.cshtmle adicione um campo Rating:

   @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. Atualize as seguintes páginas com um campo Rating:

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

O aplicativo não funcionará até que o banco de dados seja atualizado para incluir o novo campo. A execução do aplicativo sem uma atualização no banco de dados gera uma SqlException:

SqlException: Invalid column name 'Rating'.

A exceção SqlException é causada por a classe de modelo Movie atualizada ser diferente do esquema da tabela Movie do banco de dados. 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 usando o novo esquema de classe de modelo. Essa abordagem é conveniente no início do ciclo de desenvolvimento, pois ela permite que você desenvolva rapidamente o modelo e o esquema de banco de dados juntos. A desvantagem é que você perde os dados existentes no banco de dados. Não use essa abordagem em um banco de dados de produção. A remoção do banco de dados em alterações de esquema e o uso de um inicializador para propagar automaticamente o banco de dados com os dados de teste é muitas vezes uma maneira produtiva de desenvolver um aplicativo.
2. Modifique explicitamente o esquema do banco de dados existente para que ele corresponda às classes de modelo. A vantagem dessa abordagem é manter os dados. Faça essa alteração manualmente ou criando um script de alteração de banco de dados.
3. Use EF Core Migrações para atualizar o esquema de banco de dados.

Para este tutorial, use EF Core Migrações.

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

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

Consulte o arquivo SeedData.cs concluído.

Criar o aplicativo

Visual Studio

Pressione CTRL+SHIFT+B

Visual Studio Code

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

dotnet build

Visual Studio

Adicionar uma migração para o campo de classificação

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

2. No PMC (Console do Gerenciador de Pacotes), Insira o seguinte comando:

   Add-Migration Rating
   

O comando Add-Migration informa à estrutura:

• Compare o modelo de Movie com o esquema de banco de dados Movie.
• Crie código para migrar o esquema de 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.

2. No PMC, insira o seguinte comando:

   Update-Database
   

O comando Update-Database informa à estrutura para aplicar as alterações de esquema ao banco de dados e preservar os dados existentes.

Excluir todos os registros no banco de dados fará com que o inicializador propague o banco de dados e inclua o campo Rating. A exclusão pode ser feita com os links de exclusão no navegador ou no SSOX (Pesquisador de Objetos do SQL Server).

Outra opção é excluir o banco de dados e usar as migrações para recriar o banco de dados. Para excluir o banco de dados no SSOX:

1. Selecione o banco de dados no SSOX.

2. Clique com o botão direito do mouse no banco de dados e selecione Excluir.

3. Marque Fechar conexões existentes.

4. Selecione OK.

5. No PMC, atualize o banco de dados:

   Update-Database
   

Visual Studio Code

Adicionar uma migração para classificação

Use os seguintes comandos para adicionar uma migração ao campo de classificação:

dotnet ef migrations add rating
dotnet ef database update

O comando dotnet ef migrations add rating informa à estrutura:

• Compare o modelo de Movie com o esquema de banco de dados Movie.
• Crie código para migrar o esquema de banco de dados para o novo modelo.

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

O comando dotnet ef database update informa à estrutura para aplicar as alterações de esquema ao banco de dados e preservar os dados existentes.

Excluir todos os registros no banco de dados fará com que o inicializador propague o banco de dados e inclua o campo Rating.

Opcional: remover e recriar o banco de dados para outros provedores

Ignore esta seção se você migrou com êxito o banco de dados.

Neste tutorial, os recursos de migrações do Entity Framework Core são usadas 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 compatíveis com o provedor do EF Core, sendo que alguns recursos do provedor são limitados. Por exemplo, pode haver suporte para a adição de uma coluna, mas não para a remoção ou 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, você pode remover e recriar o banco de dados.

A solução alternativa para as limitações é gravar manualmente o código de 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

1. Exclua a pasta de migração.

2. Use os comandos a seguir para recriar o banco de dados.

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

Execute o aplicativo e verifique se você pode criar, editar e exibir filmes com um campo Rating. Se o banco de dados não for propagado, defina um ponto de interrupção no método SeedData.Initialize.

Próximas etapas

Anterior: Adicionar PesquisaPróximo: Adicionar Validação