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

Artigo
11/06/2024

Observação

Esta não é a versão mais recente deste artigo. Para informações sobre a versão vigente, confira a Versão do .NET 8 deste artigo.

Aviso

Esta versão do ASP.NET Core não tem mais suporte. Para obter mais informações, confira .NET e a Política de Suporte do .NET Core. Para informações sobre a versão vigente, confira a Versão do .NET 8 deste artigo.

Importante

Essas informações relacionam-se ao produto de pré-lançamento, que poderá ser substancialmente modificado antes do lançamento comercial. A Microsoft não oferece nenhuma garantia, explícita ou implícita, quanto às informações fornecidas aqui.

Para informações sobre a versão vigente, confira a Versão do .NET 8 deste artigo.

By Rick Anderson e Jon P Smith.

O objeto MvcMovieContext cuida da tarefa de se conectar ao banco de dados e mapear objetos Movie para registros do banco de dados. O contexto do banco de dados é registrado com o contêiner Injeção de dependência no arquivo Program.cs:

Visual Studio
Visual Studio Code

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 de Configuração do ASP.NET Core lê a chave ConnectionString. Para o 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 de Configuração do ASP.NET Core lê a ConnectionString. Para o desenvolvimento local, ele obtém a cadeia de conexão do arquivo appsettings.json:

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

Aviso

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.

Visual Studio
Visual Studio Code

SQL Server Express LocalDB

LocalDB:

É uma versão leve do Mecanismo de Banco de Dados do SQL Server Express, instalada por padrão com o Visual Studio.
Inicia sob demanda usando uma cadeia de conexão.
É direcionado para o desenvolvimento de programas. É executado no modo de usuário e, 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 SSOX (Pesquisador de Objetos do SQL Server).

Clique com o botão direito do mouse na Movie tabela (dbo.Movie) > Designer de Exibição

Clique com o botão direito do mouse na tabela Filme > Designer de Exibição

Tabela Movie aberta no Designer

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

Clique com o botão direito na tabela Movie>Dados de Exibição

Clique com o botão direito do mouse na tabela Filme > Dados de Exibição

SQLite

O site do SQLite afirma:

O SQLite é um mecanismo de banco de dados SQL independente, de alta confiabilidade, inserido, completo e de domínio público. O SQLite é o mecanismo de banco de dados mais usado no mundo.

Há muitas ferramentas de terceiros que podem ser baixadas para gerenciar e exibir um banco de dados SQLite. A imagem abaixo é do Navegador do DB para SQLite. Se você tiver uma ferramenta favorita do SQLite, deixe um comentário sobre o que mais gosta dela.

Navegador do BD do SQLite mostrando o BD de filmes

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:

Propagar 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 um filme no banco de dados, o inicializador de semeadura será retornado e nenhum filme será adicionado.

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

Substitua o conteúdo de Program.cs pelo seguinte código. O novo código está realçado.

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. Faça isso com os links Excluir no navegador ou no SSOX.

Testar o aplicativo. Force o aplicativo a ser inicializado, chamando o código no arquivo Program.cs) para que o método de propagação 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 Program.cs com o seguinte código realçado:

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.

Testar o aplicativo. Interrompa-o e reinicie-o para que o método SeedData.Initialize execute e gere o banco de dados.

O aplicativo mostra os dados propagados.

Aplicativo de filme MVC aberto no Microsoft Edge, mostrando os dados do filme

Anterior: adicionar um modelo Avançar: adicionar métodos e exibições do controlador

Visual Studio
Visual Studio Code/Visual Studio para Mac

var builder = WebApplication.CreateBuilder(args);

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

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

"ConnectionStrings": {
  "MvcMovieContext": "Data Source=MvcMovieContext-ea7a4069-f366-4742-bd1c-3f753a804ce1.db"
}

var builder = WebApplication.CreateBuilder(args);

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

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

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

Aviso

Visual Studio
Visual Studio Code/Visual Studio para Mac

SQL Server Express LocalDB

LocalDB:

É uma versão leve do Mecanismo de Banco de Dados do SQL Server Express, instalada por padrão com o Visual Studio.
Inicia sob demanda usando uma cadeia de conexão.
É direcionado para o desenvolvimento de programas. É executado no modo de usuário e, 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 SSOX (Pesquisador de Objetos do SQL Server).

Clique com o botão direito do mouse na Movie tabela (dbo.Movie) > Designer de Exibição

Clique com o botão direito do mouse na tabela Filme > Designer de Exibição

Tabela Movie aberta no Designer

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

Clique com o botão direito na tabela Movie>Dados de Exibição

Clique com o botão direito do mouse na tabela Filme > Dados de Exibição

SQLite

O site do SQLite afirma:

O SQLite é um mecanismo de banco de dados SQL independente, de alta confiabilidade, inserido, completo e de domínio público. O SQLite é o mecanismo de banco de dados mais usado no mundo.

Navegador do BD do SQLite mostrando o BD de filmes

Observação

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:

Propagar 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 um filme no banco de dados, o inicializador de semeadura será retornado e nenhum filme será adicionado.

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

Adicionar o inicializador de semeadura

Visual Studio
Visual Studio Code/Visual Studio para Mac

Substitua o conteúdo de Program.cs pelo seguinte código. O novo código está realçado.

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")));

// 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.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

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

app.Run();

Exclua todos os registros no banco de dados. Faça isso com os links Excluir no navegador ou no SSOX.

Atualize Program.cs com o seguinte código realçado:

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.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

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

app.Run();

Exclua todos os registros no banco de dados.

Testar o aplicativo. Interrompa-o e reinicie-o para que o método SeedData.Initialize execute e gere o banco de dados.

O aplicativo mostra os dados propagados.

Aplicativo de filme MVC aberto no Microsoft Edge, mostrando os dados do filme

Anterior: adicionar um modelo Avançar: adicionar métodos e exibições do controlador

Visual Studio
Visual Studio Code/Visual Studio para Mac

var builder = WebApplication.CreateBuilder(args);

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

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

"ConnectionStrings": {
  "MvcMovieContext": "Data Source=MvcMovieContext-ea7a4069-f366-4742-bd1c-3f753a804ce1.db"
}

var builder = WebApplication.CreateBuilder(args);

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

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

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

Aviso

Visual Studio
Visual Studio Code/Visual Studio para Mac

SQL Server Express LocalDB

LocalDB:

É uma versão leve do Mecanismo de Banco de Dados do SQL Server Express, instalada por padrão com o Visual Studio.
Inicia sob demanda usando uma cadeia de conexão.
É direcionado para o desenvolvimento de programas. É executado no modo de usuário e, 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 SSOX (Pesquisador de Objetos do SQL Server).

Clique com o botão direito do mouse na Movie tabela (dbo.Movie) > Designer de Exibição

Clique com o botão direito do mouse na tabela Filme > Designer de Exibição

Tabela Movie aberta no Designer

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

Clique com o botão direito na tabela Movie>Dados de Exibição

Clique com o botão direito do mouse na tabela Filme > Dados de Exibição

SQLite

O site do SQLite afirma:

O SQLite é um mecanismo de banco de dados SQL independente, de alta confiabilidade, inserido, completo e de domínio público. O SQLite é o mecanismo de banco de dados mais usado no mundo.

Navegador do BD do SQLite mostrando o BD de filmes

Observação

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:

Propagar 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 um filme no banco de dados, o inicializador de semeadura será retornado e nenhum filme será adicionado.

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

Adicionar o inicializador de semeadura

Visual Studio
Visual Studio Code/Visual Studio para Mac

Substitua o conteúdo de Program.cs pelo seguinte código. O novo código está realçado.

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")));

// 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.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

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

app.Run();

Exclua todos os registros no banco de dados. Faça isso com os links Excluir no navegador ou no SSOX.

Atualize Program.cs com o seguinte código realçado:

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.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

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

app.Run();

Exclua todos os registros no banco de dados.

Testar o aplicativo. Interrompa-o e reinicie-o para que o método SeedData.Initialize execute e gere o banco de dados.

O aplicativo mostra os dados propagados.

Aplicativo de filme MVC aberto no Microsoft Edge, mostrando os dados do filme

Anterior: adicionar um modelo Avançar: adicionar métodos e exibições do controlador

Visual Studio
Visual Studio Code/Visual Studio para Mac

var builder = WebApplication.CreateBuilder(args);

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

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

"ConnectionStrings": {
  "MvcMovieContext": "Server=(localdb)\\mssqllocaldb;Database=MvcMovieContext-7dc5;Trusted_Connection=True;MultipleActiveResultSets=true"
}

var builder = WebApplication.CreateBuilder(args);

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

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

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

Aviso

Visual Studio
Visual Studio Code/Visual Studio para Mac

SQL Server Express LocalDB

LocalDB:

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

SQLite

O site do SQLite afirma:

O SQLite é um mecanismo de banco de dados SQL independente, de alta confiabilidade, inserido, completo e de domínio público. O SQLite é o mecanismo de banco de dados mais usado no mundo.

Navegador do BD do SQLite mostrando o BD de filmes

Observação

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:

Propagar 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 um filme no banco de dados, o inicializador de semeadura será retornado e nenhum filme será adicionado.

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

Adicionar o inicializador de semeadura

Visual Studio
Visual Studio Code/Visual Studio para Mac

Substitua o conteúdo de Program.cs pelo seguinte código. O novo código está realçado.

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")));

// 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.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

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

app.Run();

Exclua todos os registros no banco de dados. Faça isso com os links Excluir no navegador ou no SSOX.

Atualize Program.cs com o seguinte código realçado:

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.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

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

app.Run();

Exclua todos os registros no banco de dados.

Testar o aplicativo. Interrompa-o e reinicie-o para que o método SeedData.Initialize execute e gere o banco de dados.

O aplicativo mostra os dados propagados.

Aplicativo de filme MVC aberto no Microsoft Edge, mostrando os dados do filme

Anterior: adicionar um modelo Avançar: adicionar métodos e exibições do controlador

O objeto MvcMovieContext cuida da tarefa de se conectar ao banco de dados e mapear objetos Movie para registros do banco de dados. O contexto de banco de dados é registrado com o contêiner Injeção de Dependência no método ConfigureServices em Startup.cs:

Visual Studio
Visual Studio Code/Visual Studio para Mac

public void ConfigureServices(IServiceCollection services)
{
    services.AddControllersWithViews();

    services.AddDbContext<MvcMovieContext>(options =>
    options.UseSqlServer(Configuration.GetConnectionString("MvcMovieContext")));
}

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

"ConnectionStrings": {
  "MvcMovieContext": "Server=(localdb)\\mssqllocaldb;Database=MvcMovieContext-2;Trusted_Connection=True;MultipleActiveResultSets=true"
}

public void ConfigureServices(IServiceCollection services)
{
    services.AddControllersWithViews();
    
    services.AddDbContext<MvcMovieContext>(options =>
    options.UseSqlite(Configuration.GetConnectionString("MvcMovieContext")));
}

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

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

Aviso

Visual Studio
Visual Studio Code/Visual Studio para Mac

SQL Server Express LocalDB

LocalDB:

É uma versão leve do Mecanismo de Banco de Dados do SQL Server Express, instalada por padrão com o Visual Studio.
Inicia sob demanda usando uma cadeia de conexão.
É direcionado para o desenvolvimento de programas. É executado no modo de usuário e, 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 SSOX (Pesquisador de Objetos do SQL Server).

Menu de exibição

Clique com o botão direito na tabela Movie>Designer de Exibição

Clique com o botão direito do mouse na tabela Movie > Designer de Exibição

Tabela Movie aberta no Designer

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

Clique com o botão direito na tabela Movie>Dados de Exibição

Clique com o botão direito do mouse na tabela Movie > Dados de Exibição

Tabela Movie aberta mostrando os dados da tabela

SQLite

O site do SQLite afirma:

O SQLite é um mecanismo de banco de dados SQL independente, de alta confiabilidade, inserido, completo e de domínio público. O SQLite é o mecanismo de banco de dados mais usado no mundo.

Navegador do BD do SQLite mostrando o BD de filmes

Observação

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:

Propagar 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 um filme no banco de dados, o inicializador de semeadura será retornado e nenhum filme será adicionado.

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

Adicionar o inicializador de semeadura

Substitua o conteúdo de Program.cs pelo seguinte código:

using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.Logging;
using MvcMovie.Data;
using MvcMovie.Models;
using System;

namespace MvcMovie
{
    public class Program
    {
        public static void Main(string[] args)
        {
            var host = CreateHostBuilder(args).Build();

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

                try
                {
                    SeedData.Initialize(services);
                }
                catch (Exception ex)
                {
                    var logger = services.GetRequiredService<ILogger<Program>>();
                    logger.LogError(ex, "An error occurred seeding the DB.");
                }
            }

            host.Run();

        }

        public static IHostBuilder CreateHostBuilder(string[] args) =>
            Host.CreateDefaultBuilder(args)
                .ConfigureWebHostDefaults(webBuilder =>
                {
                    webBuilder.UseStartup<Startup>();
                });
    }
}

Testar o aplicativo.

Visual Studio
Visual Studio Code/Visual Studio para Mac

Exclua todos os registros no banco de dados. Faça isso com os links Excluir no navegador ou no SSOX.

Force o aplicativo a ser inicializado, chamando os métodos na classe Startup para que o método de semeadura seja executado. Para forçar a inicialização, o IIS Express deve ser interrompido e reiniciado. Faça isso com uma das seguintes abordagens:

Clique com botão direito do mouse no ícone na bandeja do sistema do IIS Express na área de notificação e toque em Sair ou em Parar site:
- Se você estiver executando o VS no modo sem depuração, pressione F5 para executar no modo de depuração
- Se você estiver executando o VS no modo de depuração, pare o depurador e pressione F5

O aplicativo mostra os dados propagados.

Aplicativo de filme MVC aberto no Microsoft Edge, mostrando os dados do filme

Anterior: adicionar um modelo Avançar: adicionar métodos e exibições do controlador

Compartilhar via

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

SQL Server Express LocalDB

Examinar o banco de dados

SQLite

Propagar o banco de dados

Adicionar o inicializador de semeadura

SQL Server Express LocalDB

Examinar o banco de dados

SQLite

Propagar o banco de dados

Adicionar o inicializador de semeadura

SQL Server Express LocalDB

Examinar o banco de dados

SQLite

Propagar o banco de dados

Adicionar o inicializador de semeadura

SQL Server Express LocalDB

SQLite

Propagar o banco de dados

Adicionar o inicializador de semeadura

SQL Server Express LocalDB

Examinar o banco de dados

SQLite

Propagar o banco de dados

Adicionar o inicializador de semeadura

Recursos adicionais