Parte 5, trabalhar com um banco de dados em um aplicativo MVC ASP.NET Core

Por Rick Anderson e Jon P Smith.

Introdução

Esta parte da série de tutoriais foca-se em trabalhar com uma base de dados SQL na sua aplicação ASP.NET Core MVC.

Vai aprender como:

• Registe e configure o contexto da base de dados Entity Framework Core para a sua aplicação ASP.NET Core MVC.
• Trabalhar com cadeias de ligação a bases de dados para desenvolvimento local.
• Use o SQL Server Express LocalDB para desenvolvimento e examine a sua base de dados e dados usando o SQL Server Object Explorer.
• Preencha a sua base de dados com dados de exemplo iniciais.

Pré-requisito

Este tutorial utiliza uma base de dados que configurou no passo anterior: Parte 4, adicionar um modelo a uma aplicação Core MVC ASP.NET.

Trabalhar com o contexto da base de dados

O objeto MvcMovieContext lida com a tarefa de se conectar à base de dados e mapear objetos Movie para registos de base de dados. O contexto da base de dados está registado no container Dependency Injection no ficheiro Program.cs.

Estúdio Visual

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddDbContext<MvcMovieContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("MvcMovieContext") ?? throw new InvalidOperationException("Connection string 'MvcMovieContext' not found.")));

O sistema ASP.NET Core Configuration lê a chave ConnectionString. Para desenvolvimento local, ele obtém a cadeia de conexão do arquivo appsettings.json:

"ConnectionStrings": {
  "MvcMovieContext": "Server=(localdb)\\mssqllocaldb;Database=MvcMovieContext-4ebefa10-de29-4dea-b2ad-8a8dc6bcf374;Trusted_Connection=True;MultipleActiveResultSets=true"
}

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddDbContext<MvcMovieContext>(options =>
    options.UseSqlite(builder.Configuration.GetConnectionString("MvcMovieContext")));

O sistema ASP.NET Core Configuration lê o ConnectionString. Para desenvolvimento local, ele obtém a cadeia de conexão do arquivo appsettings.json:

"ConnectionStrings": {
  "MvcMovieContext": "Data Source=MvcMovie.db"
}

Advertência

Este artigo usa um banco de dados local que não exige que o usuário seja autenticado. Os aplicativos de produção devem usar o fluxo de autenticação mais seguro disponível. Para obter mais informações sobre autenticação para aplicativos de teste e produção implantados, consulte Fluxos de autenticação seguros.

Estúdio Visual

SQL Server Express LocalDB (versão local do SQL Server Express)

LocalDB:

• É uma versão leve do Mecanismo de Banco de Dados do SQL Server Express, instalado por padrão com o Visual Studio.
• Inicia sob demanda usando uma cadeia de conexão.
• Está direcionado para o desenvolvimento de programas. Ele é executado no modo de usuário, portanto, não há nenhuma configuração complexa.
• Por padrão, cria arquivos .mdf no diretório C:/Users/{user}.

Examinar o banco de dados

No menu Exibir, abra o Pesquisador de Objetos do SQL Server (SSOX).

Clique com o botão direito do rato na tabela Movie (dbo.Movie) > View Designer

Observe o ícone de chave ao lado de ID. Por padrão, o EF cria uma propriedade chamada ID chave primária.

Clique com o botão direito do rato na tabela Movie> Ver Dados

SQLite

O site SQLite afirma:

SQLite é um mecanismo de banco de dados SQL autônomo, de alta confiabilidade, incorporado, completo e de domínio público. SQLite é o mecanismo de banco de dados mais usado no mundo.

Há muitas ferramentas de terceiros que você pode baixar para gerenciar e visualizar um banco de dados SQLite. A imagem abaixo é do DB Browser for SQLite. Se você tem uma ferramenta SQLite favorita, deixe um comentário sobre o que você gosta sobre ela.

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 e recria 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

Semear o banco de dados

Crie uma nova classe chamada SeedData na pasta Models. Substitua o código gerado pelo seguinte:

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using MvcMovie.Data;
using System;
using System.Linq;

namespace MvcMovie.Models;

public static class SeedData
{
    public static void Initialize(IServiceProvider serviceProvider)
    {
        using (var context = new MvcMovieContext(
            serviceProvider.GetRequiredService<
                DbContextOptions<MvcMovieContext>>()))
        {
            // Look for any movies.
            if (context.Movie.Any())
            {
                return;   // DB has been seeded
            }
            context.Movie.AddRange(
                new Movie
                {
                    Title = "When Harry Met Sally",
                    ReleaseDate = DateTime.Parse("1989-2-12"),
                    Genre = "Romantic Comedy",
                    Price = 7.99M
                },
                new Movie
                {
                    Title = "Ghostbusters ",
                    ReleaseDate = DateTime.Parse("1984-3-13"),
                    Genre = "Comedy",
                    Price = 8.99M
                },
                new Movie
                {
                    Title = "Ghostbusters 2",
                    ReleaseDate = DateTime.Parse("1986-2-23"),
                    Genre = "Comedy",
                    Price = 9.99M
                },
                new Movie
                {
                    Title = "Rio Bravo",
                    ReleaseDate = DateTime.Parse("1959-4-15"),
                    Genre = "Western",
                    Price = 3.99M
                }
            );
            context.SaveChanges();
        }
    }
}

Se houver algum filme no banco de dados, o inicializador de semente retornará e nenhum filme será adicionado.

if (context.Movie.Any())
{
    return;  // DB has been seeded.
}

Adicionar o inicializador de semente

Estúdio Visual

Substitua o conteúdo do Program.cs pelo código a seguir. O novo código é destacado.

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using MvcMovie.Data;
using MvcMovie.Models;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddDbContext<MvcMovieContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("MvcMovieContext") ?? throw new InvalidOperationException("Connection string 'MvcMovieContext' not found.")));

// Add services to the container.
builder.Services.AddControllersWithViews();

var app = builder.Build();

using (var scope = app.Services.CreateScope())
{
    var services = scope.ServiceProvider;

    SeedData.Initialize(services);
}

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Home/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

app.UseHttpsRedirection();

app.UseRouting();

app.UseAuthorization();

app.MapStaticAssets();

app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");

app.Run();

Exclua todos os registros no banco de dados. Você pode fazer isso com os links de exclusão no navegador ou do SSOX.

Teste o aplicativo. Força o aplicativo a inicializar, chamando o código no arquivo Program.cs, para que o método seed seja executado. Para forçar a inicialização, feche a janela do prompt de comando que o Visual Studio abriu e reinicie pressionando Ctrl+F5.

Atualize o Program.cs com o código destacado a seguir:

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using MvcMovie.Data;
using MvcMovie.Models;
var builder = WebApplication.CreateBuilder(args);

builder.Services.AddDbContext<MvcMovieContext>(options =>
    options.UseSqlite(builder.Configuration.GetConnectionString("MvcMovieContext")));

// Add services to the container.
builder.Services.AddControllersWithViews();

var app = builder.Build();

using (var scope = app.Services.CreateScope())
{
    var services = scope.ServiceProvider;

    SeedData.Initialize(services);
}

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Home/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

app.UseHttpsRedirection();

app.UseRouting();

app.UseAuthorization();

app.MapStaticAssets();

app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");

app.Run();

Exclua todos os registros no banco de dados.

Teste o aplicativo. Pare e reinicie-o para que o método SeedData.Initialize seja executado e popule a base de dados.

A aplicação mostra os dados pré-definidos.

Anterior: Adicionando um modeloPróximo: Adicionando métodos e exibições do controlador