Parte 4 da série de tutoriais sobre Razor Pages

Por Joe Audette

O objeto RazorPagesMovieContext 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 em Program.cs:

Visual Studio

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

// Add services to the container.
builder.Services.AddRazorPages();
builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

Visual Studio Code/Visual Studio para Mac

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

// Add services to the container.
builder.Services.AddRazorPages();
builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
    options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

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

Visual Studio

A cadeia de conexão gerada é semelhante ao seguinte JSON:

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft": "Warning",
      "Microsoft.Hosting.Lifetime": "Information"
    }
  },
  "AllowedHosts": "*",
  "ConnectionStrings": {
    "RazorPagesMovieContext": "Server=(localdb)\\mssqllocaldb;Database=RazorPagesMovieContext-bc;Trusted_Connection=True;MultipleActiveResultSets=true"
  }
}

Visual Studio Code/Visual Studio para Mac

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "AllowedHosts": "*",
  "ConnectionStrings": {
    "RazorPagesMovieContext": "Data Source=RazorPagesMovie.Data.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

SQL Server Express LocalDB

O LocalDB é uma versão leve do mecanismo de banco de dados do SQL Server Express direcionada para o desenvolvimento de programas. O LocalDB é iniciado sob demanda e executado no modo de usuário e, portanto, não há nenhuma configuração complexa. Por padrão, o banco de dados LocalDB cria arquivos *.mdf no diretório C:\Users\<user>\.

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

   

2. Clique com o botão direito do mouse na tabela Movie e selecione Designer de exibição:

   

   

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

3. Clique com o botão direito do mouse na tabela Movie e selecione Exibir dados:

   

Visual Studio Code/Visual Studio para Mac

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.

Observação

Neste tutorial, o recurso de migrações do Entity Framework Core é usado 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 é alterado, o banco de dados é descartado e recriado.

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:

• 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

Propagar o banco de dados

Crie uma classe chamada SeedData na pasta Models com o seguinte código:

using Microsoft.EntityFrameworkCore;
using RazorPagesMovie.Data;

namespace RazorPagesMovie.Models;

public static class SeedData
{
    public static void Initialize(IServiceProvider serviceProvider)
    {
        using (var context = new RazorPagesMovieContext(
            serviceProvider.GetRequiredService<
                DbContextOptions<RazorPagesMovieContext>>()))
        {
            if (context == null || context.Movie == null)
            {
                throw new ArgumentNullException("Null RazorPagesMovieContext");
            }

            // 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 propagação será retornado e nenhum filme será adicionado.

if (context.Movie.Any())
{
    return;
}

Adicionar o inicializador de semeadura

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

Visual Studio

using Microsoft.EntityFrameworkCore;
using RazorPagesMovie.Data;
using RazorPagesMovie.Models;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();
builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

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

    SeedData.Initialize(services);
}

if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

Visual Studio Code/Visual Studio para Mac

using Microsoft.EntityFrameworkCore;
using RazorPagesMovie.Data;
using RazorPagesMovie.Models;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();
builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
    options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

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

    SeedData.Initialize(services);
}

if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

No código anterior, Program.cs foi modificado para fazer o seguinte:

• Obter uma instância de contexto de banco de dados do contêiner de DI (injeção de dependência).
• Chame o método seedData.Initialize, passando para ele a instância de contexto do banco de dados.
• Descarte o contexto quando o método de semente for concluído. A instrução using garante que o contexto seja descartado.

A seguinte exceção ocorre quando Update-Database não foi executado:

SqlException: Cannot open database "RazorPagesMovieContext-" requested by the login. The login failed. Login failed for user 'user name'.

Testar o aplicativo

Exclua todos os registros no banco de dados para que o método de propagação seja executado. Interrompa e inicie o aplicativo para propagar o banco de dados. Se o banco de dados não for propagado, coloque um ponto de interrupção em if (context.Movie.Any()) e examine cada etapa do código.

O aplicativo mostra os dados propagados:

Próximas etapas

Anterior: Páginas do Razor geradas por scaffoldingEm seguida: atualize as páginas