Parte 7, adicionar um novo campo numa Página de Razor no ASP.NET Core

Por Rick Anderson

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

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

A abordagem EF Core permite um processo de desenvolvimento mais ágil. O desenvolvedor trabalha no modelo de dados do aplicativo diretamente enquanto o esquema de banco de dados é criado e, em seguida, sincronizado, tudo sem que o desenvolvedor tenha que alternar contextos de e para uma ferramenta de gerenciamento de banco 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 rastrear automaticamente um banco de dados:

• Adiciona uma tabela __EFMigrationsHistory ao banco de dados para controlar se o esquema do banco de dados está sincronizado com as classes de modelo a partir das quais foi gerado.
• Lança 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. Editar Pages/Movies/Index.cshtmle adicionar 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 para o banco de dados gera uma SqlException:

SqlException: Invalid column name 'Rating'.

A exceção SqlException é causada pela classe de modelo Movie atualizada ser diferente do esquema da tabela Movie do banco de dados. Não há nenhuma 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 usando o novo esquema de classe de modelo. Essa abordagem é conveniente no início do ciclo de desenvolvimento, permitindo que os desenvolvedores evoluam rapidamente o modelo e o esquema de banco de dados juntos. A desvantagem é que os dados existentes no banco de dados são perdidos. Não use essa abordagem em um banco de dados de produção! Descartar o banco de dados em alterações de esquema e usar um inicializador para semear automaticamente o banco de dados com dados de teste geralmente é 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 desta 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 do 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. Um exemplo de alteração é mostrado abaixo, mas faça essa alteração para 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.

Crie o aplicativo

Estúdio Visual

Pressione Ctrl+Shift+B

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

dotnet build

Estúdio Visual

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

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

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

   Add-Migration Rating
   

O comando Add-Migration diz ao framework para:

• Compare o modelo 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, digite o seguinte comando:

   Update-Database
   

O comando Update-Database instrui o framework a aplicar as alterações de esquema na base de dados e a preservar os dados existentes.

Exclua todos os registros no banco de dados, o inicializador semeará o banco de dados e incluirá o campo Rating. A eliminação pode ser feita através dos links de eliminação no navegador da web ou no Sql Server Object Explorer (SSOX).

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

1. Selecione o banco de dados em SSOX.

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

3. Marcar Fechar conexões existentes.

4. Selecione OK.

5. No PMC, atualize o banco de dados:

   Update-Database
   

Adicionar uma migração para classificação

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

dotnet ef migrations add rating
dotnet ef database update

O comando dotnet ef migrations add rating diz ao framework para:

• Compare o modelo 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 instrui o framework a aplicar as alterações de esquema na base de dados e a preservar os dados existentes.

Exclua todos os registros no banco de dados, o inicializador semeará o banco de dados e incluirá o campo Rating.

Opcional: Elimine e recrie o banco de dados para outros fornecedores.

Ignore esta seção se tiver migrado o banco de dados com êxito.

Neste tutorial, as migrações recursos do Entity Framework Core são usados quando 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 alguns recursos do provedor são limitados. Por exemplo, adicionar uma coluna pode ser suportado, mas remover ou alterar uma coluna não é. 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, pode-se eliminar e recriar o banco de dados.

A solução alternativa para as limitações é 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.
• Largando 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

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 a base de dados não estiver inicializada, coloque um ponto de interrupção no método SeedData.Initialize.

Próximos passos

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