4. část série kurzů na Razor stránkách

Od Joe Audette

Objekt RazorPagesMovieContext zpracovává úlohu připojení k databázi a mapování Movie objektů na záznamy databáze. Kontext databáze je zaregistrovaný v kontejneru injektáže závislostí v 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 pro 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();

Systém ASP.NET Core Configuration načte ConnectionString klíč. Pro místní vývoj získá konfigurace připojovací řetězec ze appsettings.json souboru.

Visual Studio

Vygenerovaný připojovací řetězec se podobá následující JSfunkci ON:

{
  "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 pro Mac

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "AllowedHosts": "*",
  "ConnectionStrings": {
    "RazorPagesMovieContext": "Data Source=RazorPagesMovie.Data.db"
  }
}

Když je aplikace nasazená na testovací nebo produkční server, můžete proměnnou prostředí použít k nastavení připojovací řetězec na testovací nebo produkční databázový server. Další informace najdete v tématu Konfigurace.

Visual Studio

SQL Server Express LocalDB

LocalDB je zjednodušená verze databázového stroje SQL Server Express, která je určená pro vývoj programů. LocalDB se spouští na vyžádání a spouští se v uživatelském režimu, takže neexistuje složitá konfigurace. Ve výchozím nastavení vytvoří *.mdf databáze LocalDB soubory v C:\Users\<user>\ adresáři.

1. V nabídce Zobrazení otevřete SQL Server Průzkumník objektů (SSOX).

   

2. Klikněte pravým tlačítkem myši na Movie tabulku a vyberte Návrhář zobrazení:

   

   

   Poznamenejte si ikonu klávesy vedle IDtlačítka . Ef ve výchozím nastavení vytvoří vlastnost pojmenovanou ID pro primární klíč.

3. Klikněte pravým tlačítkem myši na Movie tabulku a vyberte Zobrazit data:

   

Visual Studio Code / Visual Studio pro Mac

SQLite

Web SQLite uvádí:

SQLite je samostatný databázový stroj SQL s vysokou spolehlivostí, vloženou, plně funkční, veřejnou doménou a databázovým strojem SQL. SQLite je nejpoužívanější databázový stroj na světě.

Ke správě a zobrazení databáze SQLite si můžete stáhnout mnoho nástrojů třetích stran. Následující obrázek je z prohlížeče DB pro SQLite. Pokud máte oblíbený nástroj SQLite, zanechte komentář k tomu, co se vám líbí.

Poznámka:

V tomto kurzu se funkce migrace Entity Framework Core používá tam, kde je to možné. Migrace aktualizuje schéma databáze tak, aby odpovídalo změnám datového modelu. Migrace ale můžou provádět pouze druhy změn, které EF Core poskytovatel podporuje, a možnosti poskytovatele SQLite jsou omezené. Přidání sloupce se například podporuje, ale odebrání nebo změna sloupce se nepodporuje. Pokud se vytvoří migrace pro odebrání nebo změnu sloupce, příkaz bude úspěšný, ef migrations add ale ef database update příkaz selže. Vzhledem k těmto omezením tento kurz nepoužívá migrace pro změny schématu SQLite. Místo toho se při změně schématu databáze zahodí a znovu vytvoří.

Alternativním řešením pro omezení SQLite je ruční zápis kódu migrace, který provede opětovné sestavení tabulky, když se něco v tabulce změní. Opětovné sestavení tabulky zahrnuje:

• Vytvoření nové tabulky
• Kopírování dat ze staré tabulky do nové tabulky
• Přehození staré tabulky.
• Přejmenování nové tabulky

Další informace naleznete v následujících zdrojích:

• Omezení zprostředkovatele databáze SQLite EF Core
• Přizpůsobení kódu migrace
• Počáteční data
• Příkaz SQLite ALTER TABLE

Počáteční hodnota databáze

Ve složce Models vytvořte novou třídu SeedData s následujícím kódem:

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();
        }
    }
}

Pokud jsou v databázi nějaké filmy, počáteční inicializátor vrátí a nepřidají se žádné filmy.

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

Přidání inicializátoru počátečního nastavení

Program.cs Aktualizujte následující zvýrazněný kód:

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 pro 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();

V předchozím kódu byl upraven tak, Program.cs aby postupoval následovně:

• Získejte instanci kontextu databáze z kontejneru injektáže závislostí (DI).
• Zavolejte metodu seedData.Initialize a předejte jí instanci kontextu databáze.
• Jakmile se počáteční metoda dokončí, odstraňte kontext. Příkaz using zajistí, že se kontext odstraní.

K následující výjimce dochází v případě Update-Database , že nebyla spuštěna:

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

Otestování aplikace

Odstraňte všechny záznamy v databázi, aby se spustila počáteční metoda. Zastavte a spusťte aplikaci, aby se databáze zasadila. Pokud databáze není počáteční, vložte zarážku if (context.Movie.Any()) a krokujte kódem.

Aplikace zobrazuje počáteční data:

Další kroky

Předchozí: Další vygenerované Razor stránky: Aktualizace stránek