A Pages oktatóanyag-sorozatának Razor 4. része

Készítette: Joe Audette

A RazorPagesMovieContext objektum kezeli az adatbázishoz való csatlakozás és Movie objektumok adatbázisrekordokhoz való leképezésének feladatát. Az adatbázis-környezet a Dependency Injection tárolóban van regisztrálva 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.")));

Visual Studio Code

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.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.")));

var app = builder.Build();

A ASP.NET Core Configuration rendszer beolvassa a ConnectionString kulcsot. A helyi fejlesztés során a beállítások lekérik a kapcsolati sztringet a appsettings.json fájlból.

Visual Studio

A létrehozott kapcsolati sztring a következő JSON-hoz hasonló:

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "AllowedHosts": "*",
  "ConnectionStrings": {
    "RazorPagesMovieContext": "Server=(localdb)\\mssqllocaldb;Database=RazorPagesMovieContext-f2e0482c-952d-4b1c-afe9-a1a3dfe52e55;Trusted_Connection=True;MultipleActiveResultSets=true"
  }
}

Visual Studio Code

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

Warning

Ez a cikk egy helyi adatbázist használ, amely nem igényli a felhasználó hitelesítését. A termelésben használt alkalmazásoknak az elérhető legbiztonságosabb hitelesítési folyamatot kell használniuk. Az üzembe helyezett teszt- és éles alkalmazások hitelesítéséről további információt Biztonságos hitelesítési folyamatokcímű témakörben talál.

Visual Studio

SQL Server Express LocalDB (helyi adatbáziskezelő szoftver)

A LocalDB az SQL Server Express adatbázismotor egyszerűsített verziója, amely programfejlesztésre szolgál. A LocalDB igény szerint indul el, és felhasználói módban fut, így nincs összetett konfiguráció. Alapértelmezés szerint a LocalDB-adatbázis fájlokat hoz létre *.mdf a C:\Users\<user>\ könyvtárban.

1. A Nézet menüben nyissa meg SQL Server Object Explorer (SSOX).

   

2. Kattintson a jobb gombbal a Movie táblára, és válassza Nézettervező:

   

   

   Figyelje meg a IDmelletti kulcsikont. Alapértelmezés szerint az EF létrehoz egy, az elsődleges kulcsnak nevezett ID tulajdonságot.

3. Kattintson a jobb gombbal a Movie táblára, és válassza Adatok megtekintése:

   

Visual Studio Code

SQLite

A SQLite webhely a következőt állítja be:

Az SQLite egy önálló, nagy megbízhatóságú, beágyazott, teljes funkcionalitású, nyilvános tartományú SQL-adatbázismotor. Az SQLite a világ leggyakrabban használt adatbázismotorja.

Az SQLite-adatbázisok kezeléséhez és megtekintéséhez számos külső gyártótól származó eszközt tölthet le. Az alábbi kép a DB Browser for SQLite-ból származik. Ha van kedvenc SQLite-eszköze, írja meg kommentben, hogy mit szeret benne.

Note

Ebben az oktatóanyagban lehetőség szerint az Entity Framework Core migrálási funkcióját használjuk. A migrálások az adatmodell változásainak megfelelően frissítik az adatbázis sémáját. A migrálások azonban csak a EF Core szolgáltató által támogatott módosításokat hajthatják végre, és az SQLite-szolgáltató képességei korlátozottak. Például az oszlop hozzáadása támogatott, de az oszlopok eltávolítása vagy módosítása nem támogatott. Ha egy oszlop eltávolításához vagy módosításához migrálás jön létre, a ef migrations add parancs sikeres lesz, de a ef database update parancs meghiúsul. Ezen korlátozások miatt ez az oktatóanyag nem használ migrálásokat az SQLite-séma módosításaihoz. Ehelyett a séma módosításakor a rendszer elveti és újra létrehozza az adatbázist.

Az SQLite-korlátozások megkerülő megoldása az áttelepítési kód manuális írása a tábla újraépítéséhez, amikor a táblában valami megváltozik. A táblák újraépítése a következőket foglalja magában:

• Új tábla létrehozása.
• Adatok másolása a régi táblából az új táblába.
• A régi asztal elvetése.
• Az új tábla átnevezése.

További információt a következő források tartalmaznak:

• SQLite EF Core adatbázis-szolgáltatói korlátozások
• Áttelepítési kód testreszabása
• Adatbevetés
• SQLite ALTER TABLE utasítás

Az adatbázis üzembe helyezése

Hozzon létre egy új osztályt SeedData a Models mappában a következő kóddal:

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

Ha vannak filmek az adatbázisban, a seed inicializáló befejezi a működését, és nem ad hozzá filmeket.

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

Add meg a mag inicializálót

Frissítse a Program.cs következő kiemelt kóddal:

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

app.UseAuthorization();

app.MapStaticAssets();
app.MapRazorPages();

app.Run();

Visual Studio Code

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

app.UseAuthorization();

app.MapStaticAssets();
app.MapRazorPages();

app.Run();

Az előző kódban Program.cs a következő módon lett módosítva:

• Kérje le az adatbázis-környezetpéldányt a függőséginjektálási (DI) tárolóból.
• Hívja meg a metódust seedData.Initialize , és adja át neki az adatbázis-környezetpéldányt.
• Amikor a seed-függvény befejeződik, távolítsa el a kontextust. A felhasználói utasítás biztosítja, hogy a környezet el legyen osztva.

A következő kivétel akkor fordul elő, ha Update-Database nem futtatták:

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

Az alkalmazás tesztelése

Törölje az adatbázisban lévő összes rekordot, hogy a kezdő metódus fusson. Állítsa le és indítsa el az alkalmazást az adatbázis üzembe helyezése érdekében. Ha az adatbázis nincs feltöltve, helyezzen egy töréspontot a if (context.Movie.Any())-ra, és lépjen végig a kódon.

Az alkalmazás a kiemelt adatokat jeleníti meg:

Következő lépések

Előző: Felépített Razor OldalakKövetkező: A lapok frissítése