2. rész, modell hozzáadása Razor Pages-alkalmazáshoz a ASP.NET Core-ban

Ebben az oktatóanyagban osztályokat adunk hozzá az adatbázisokban lévő filmek kezeléséhez. Az alkalmazás modellosztályai Entity Framework Core (EF Core) használnak az adatbázis használatához. EF Core egy objektum-relációs leképező (O/RM), amely leegyszerűsíti az adathozzáférést. Először a modellosztályokat írja meg, és EF Core hozza létre az adatbázist.

A modellosztályokat POCO osztályoknak (a "Plain-Old CLR Objects" kifejezés alapján) nevezzük, mert nem függenek EF Core-tól. Ezek határozzák meg az adatbázisban tárolt adatok tulajdonságait.

Adatmodell hozzáadása

Visual Studio

1. A Megoldáskezelőbenkattintson a jobb gombbal a RazorPagesMovie projektre >>Új mappa hozzáadása. Nevezze el a mappát Models.

2. Kattintson a jobb gombbal a Models mappára. Válassza >osztályhozzáadása lehetőséget. Nevezze el az osztályt Film.

3. Adja hozzá a következő tulajdonságokat a Movie osztályhoz:

   using System.ComponentModel.DataAnnotations;
   
   namespace RazorPagesMovie.Models;
   
   public class Movie
   {
       public int Id { get; set; }
       public string? Title { get; set; }
       [DataType(DataType.Date)]
       public DateTime ReleaseDate { get; set; }
       public string? Genre { get; set; }
       public decimal Price { get; set; }
   }
   

A Movie osztály a következőket tartalmazza:

• A ID mezőt az adatbázisnak kell megadnia az elsődleges kulcshoz.

• Egy [DataType] attribútum, amely meghatározza a ReleaseDate tulajdonság adattípusát. Ezzel az attribútummal:

  • A felhasználónak nem kell időadatokat megadnia a dátum mezőben.
  • Csak a dátum jelenik meg, az időadatok nem.

• Az string utáni kérdőjel azt jelzi, hogy a tulajdonság null értékű. További információért tekintse meg: Null értékű hivatkozástípusok.

A DataAnnotations egy későbbi oktatóanyagban kerülnek tárgyalásra.

Hozza létre a projektet annak ellenőrzéséhez, hogy nincsenek-e fordítási hibák.

Visual Studio Code

1. Adjon hozzá egy Modelsnevű mappát.
2. Adjon hozzá egy osztályt a Modelsnevű Movie.cs mappához.

Adja hozzá a következő tulajdonságokat a Movie osztályhoz:

using System.ComponentModel.DataAnnotations;

namespace RazorPagesMovie.Models;

public class Movie
{
    public int Id { get; set; }
    public string? Title { get; set; }
    [DataType(DataType.Date)]
    public DateTime ReleaseDate { get; set; }
    public string? Genre { get; set; }
    public decimal Price { get; set; }
}

A Movie osztály a következőket tartalmazza:

• Egy ID mező az adatbázis elsődleges kulcsának megadásához.

• Egy [DataType] attribútum a ReleaseDate mező adattípusának megadásához. Ezzel az attribútummal:

  • A felhasználónak nem kell időadatokat megadnia a dátum mezőben.
  • Csak a dátum jelenik meg, az időadatok nem.

• Az string utáni kérdőjel azt jelzi, hogy a tulajdonság null értékű. További információért tekintse meg: Null értékű hivatkozástípusok.

A DataAnnotations egy későbbi oktatóanyagban kerülnek tárgyalásra.

NuGet-csomagok és EF-eszközök hozzáadása

Futtassa a következő .NET CLI-parancsokat:

dotnet tool uninstall --global dotnet-aspnet-codegenerator
dotnet tool install --global dotnet-aspnet-codegenerator
dotnet tool uninstall --global dotnet-ef
dotnet tool install --global dotnet-ef
dotnet add package Microsoft.EntityFrameworkCore.Design
dotnet add package Microsoft.EntityFrameworkCore.SQLite
dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design
dotnet add package Microsoft.EntityFrameworkCore.SqlServer
dotnet add package Microsoft.EntityFrameworkCore.Tools

Az előző parancsok hozzáadják a következőket:

• A EF Core parancssori felületének (CLI) eszközei
• Az aspnet-codegenerator keretrendszert építő eszköz.
• Tervezési időeszközök EF Core
• A EF Core SQLite-szolgáltató, amely függőségként telepíti a EF Core csomagot.
• Állványzathoz szükséges csomagok: Microsoft.VisualStudio.Web.CodeGeneration.Design és Microsoft.EntityFrameworkCore.SqlServer.

Ha több olyan környezetkonfigurációról szeretne útmutatást adni, amely lehetővé teszi az alkalmazások számára az adatbázis-környezetek környezet szerinti konfigurálását, tekintse meg ASP.NET Core futtatókörnyezeteket.

Note

Alapértelmezés szerint a telepíteni kívánt .NET bináris fájlok architektúrája a jelenleg futó operációsrendszer-architektúrát jelöli. Ha másik operációsrendszer-architektúrát szeretne megadni, tekintse meg dotnet eszköz telepítését, az --arch lehetőséget. További információ: GitHub-probléma dotnet/AspNetCore.Docs #29262.

A Visual Studio Code-ban nyomja le a Ctrl+F5 billentyűkombinációt az alkalmazás hibakeresés nélküli futtatásához.

A szerkesztőterület alatti Panel válassza a PROBLÉMÁK lapot, vagy a Nézet menüben válassza a Problémák lehetőséget, ha jelenleg nincs nézetben. Ellenőrizze, hogy nincsenek-e fordítási hibák.

Állványozza fel a filmpéldányt

Ebben a szakaszban a filmmodell keretezett van. Vagyis az állványzati eszköz oldalakat hoz létre a filmmodell létrehozási, olvasási, frissítési és törlési (CRUD) műveleteihez.

Visual Studio

1. Hozza létre a Lapok/filmek mappát:

   1. Kattintson a jobb gombbal a Lapok mappára >>Új mappa hozzáadása.
   2. Nevezze el a mappát Filmek.

2. Kattintson a jobb gombbal a Lapok/filmek mappára, >>Új állványozott elem hozzáadása.

   

3. Az Új állvány hozzáadása párbeszédpanelen válassza a Razor Lapokat az Entity Framework (CRUD) használatával>hozzáadása lehetőséget.

   

4. Töltse ki a jelölésű, az Entity Framework (CRUD) használatával hozzáadott Razor lapokat a párbeszédpanelen.

   1. A Modellosztály legördülő listában válassza a Film (RazorPagesMovie.Models)lehetőséget.
   2. Az Data context class sorban válassza ki a + (plusz) jelet.
      1. Az Adatkörnyezet hozzáadása párbeszédpanelen létre lesz hozva a RazorPagesMovie.Data.RazorPagesMovieContext osztálynév.
      2. Az Adatbázis-szolgáltató legördülő listában válassza SQL Serverlehetőséget.
   3. Válassza a Hozzáadás lehetőséget.

   

A appsettings.json fájl a helyi adatbázishoz való csatlakozáshoz használt kapcsolati sztringgel frissül.

Visual Studio Code

• Nyisson meg egy parancssori felületet a projekt könyvtárához, amely tartalmazza a Program.cs és .csproj fájlokat. Futtassa a következő parancsot:

  dotnet aspnet-codegenerator razorpage -m Movie -dc RazorPagesMovie.Data.RazorPagesMovieContext -udl -outDir Pages/Movies --referenceScriptLibraries --databaseProvider sqlite
  

Az alábbi táblázat a ASP.NET Core-kódgenerátor beállításait ismerteti.

Option	Description
-m	A modell neve.
-dc	A névtérrel együtt használandó DbContext osztály.
-udl	Használja az alapértelmezett elrendezést.
-outDir	A nézetek létrehozásához tartozó relatív kimeneti mappa útvonala.
--referenceScriptLibraries	_ValidationScriptsPartial hozzáadása lapok szerkesztéséhez és létrehozásához

A -h parancshoz a dotnet aspnet-codegenerator razorpage beállítással kérhet segítséget:

dotnet aspnet-codegenerator razorpage -h

További információ: dotnet aspnet-codegenerator.

SQLite használata fejlesztéshez, SQL Server éles környezetben

Az SQLite kiválasztásakor a sablon által létrehozott kód készen áll a fejlesztésre. Az alábbi kód bemutatja, hogyan választhatja ki az SQLite kapcsolati sztringet fejlesztési környezetben és az SQL Server sztringet éles környezetben.

using Microsoft.EntityFrameworkCore;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();

if (builder.Environment.IsDevelopment())
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlite(builder.Configuration.GetConnectionString("RazorPagesMovieContext")));
}
else
{
    builder.Services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlServer(builder.Configuration.GetConnectionString("ProductionMovieContext")));
}

var app = builder.Build();

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

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

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

Az előző kód nem hívja UseDeveloperExceptionPage fejlesztési módban, mert WebApplication fejlesztési módban hívja UseDeveloperExceptionPage-t.

Warning

Ez a cikk egy helyi adatbázist használ, amely nem igényli a felhasználó hitelesítését. Az éles 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.

Létrehozott és frissített fájlok

Az állványzati folyamat a következő fájlokat hozza létre:

• Lapok/filmek: Létrehozás, Törlés, Részletek, Szerkesztés és Indexelés.
• Data/RazorPagesMovieContext.cs

A létrehozott fájlokat a következő oktatóanyag ismerteti.

Az állványzati folyamat a következő kiemelt kódot adja hozzá a Program.cs fájlhoz:

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

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/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.MapRazorPages();

app.Run();

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

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/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.MapStaticAssets();
app.MapRazorPages();

app.Run();

A Program.cs módosításait az oktatóanyag későbbi részében ismertetjük.

A kezdeti adatbázisséma létrehozása az EF migrálási funkciójával

Az Entity Framework Core migrálási funkciója a következőket teszi lehetővé:

• Hozza létre a kezdeti adatbázissémát.
• Növekményesen frissítse az adatbázissémát, hogy szinkronban maradjon az alkalmazás adatmodelljével. Az adatbázis meglévő adatai megmaradnak.

Visual Studio

Ebben a szakaszban a Package Manager Console (PMC) ablak a következőre szolgál:

• Adjon hozzá egy kezdeti migrációt.

• Frissítse az adatbázist a kezdeti migrálással.

• Az Eszközök menüben válassza a NuGet csomagkezelő>csomagkezelő konzollehetőséget.

  

• A PMC-ben adja meg a következő parancsot:

  Add-Migration InitialCreate
  

• A Add-Migration parancs létrehoz egy kódot a kezdeti adatbázisséma létrehozásához. A séma a DbContext-ban meghatározott modellen alapul. A InitialCreate argumentum a migrálás elnevezésére szolgál. Bármilyen név használható, de konvenció szerint ki van jelölve egy név, amely leírja az áttelepítést.

A következő figyelmeztetés jelenik meg, amely egy későbbi lépésben lesz kezelve:

Nem adott meg típust a "Movie" entitástípus "Ár" tizedesoszlopához. Ez az értékek csonkolásához vezet, ha nem illeszkednek az alapértelmezett pontossághoz és mértékhez. Explicit módon adja meg azt az SQL Server-oszloptípust, amely a "HasColumnType()" használatával minden értéket el tud fogadni.

• A PMC-ben adja meg a következő parancsot:

  Update-Database
  

  A Update-Database parancs a Up metódust futtatja a nem alkalmazott migrálásokban. Ebben az esetben a parancs a Up metódust futtatja a Migrations/<time-stamp>_InitialCreate.cs fájlban, amely létrehozza az adatbázist.

Visual Studio Code

• Kattintson a jobb gombbal a RazorPagesMovie.csproj projektre, majd válassza a Megnyitás integrált terminálbanlehetőséget.

  Megnyílik a terminál ablaka a projektkönyvtár parancssorával, amely tartalmazza a Program.cs és a .csproj fájlokat.

• Futtassa a következő .NET CLI-parancsot:

  dotnet ef migrations add InitialCreate
  

  A migrations parancs létrehoz egy kódot a kezdeti adatbázisséma létrehozásához. A séma a DbContext-ban meghatározott modellen alapul. A InitialCreate argumentum az áttelepítések elnevezésére szolgál. Bármilyen név használható, de konvenció szerint ki van jelölve egy név, amely leírja az áttelepítést.

• Futtassa a következő .NET CLI-parancsot:

  dotnet ef database update
  

  A update parancs a Up metódust futtatja a nem alkalmazott migrálásokban. Ebben az esetben update futtatja a Up metódust a Migrations/<time-stamp>_InitialCreate.cs fájlban, amely létrehozza az adatbázist.

Note

SQLite esetén a Price mező oszloptípusa TEXT. Ezt egy későbbi lépésben oldjuk meg.

Az adatkörnyezet RazorPagesMovieContext:

• A Microsoft.EntityFrameworkCore.DbContext származik.
• Meghatározza, hogy mely entitások szerepelnek az adatmodellben.
• A EF Core modell Movie funkcióit koordinálja, például létrehozást, olvasást, frissítést és törlést.

A RazorPagesMovieContext osztály a létrehozott fájlban: Data/RazorPagesMovieContext.cs

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.EntityFrameworkCore;
using RazorPagesMovie.Models;

namespace RazorPagesMovie.Data
{
    public class RazorPagesMovieContext : DbContext
    {
        public RazorPagesMovieContext (DbContextOptions<RazorPagesMovieContext> options)
            : base(options)
        {
        }

        public DbSet<RazorPagesMovie.Models.Movie> Movie { get; set; } = default!;
    }
}

Az előző kód létrehoz egy DbSet<Movie> tulajdonságot az entitáskészlethez. Az Entity Framework terminológiájában az entitáskészletek általában egy adatbázistáblának felelnek meg. Az entitás a tábla egy sorának felel meg.

A kapcsolati sztring nevét a rendszer egy DbContextOptions objektum metódusának meghívásával adja át a környezetnek. Helyi fejlesztés esetén a konfigurációs rendszer beolvassa a kapcsolati sztringet a appsettings.json fájlból.

Az alkalmazás tesztelése

1. Futtassa az alkalmazást, és fűzze hozzá /Movies a böngésző URL-címéhez (http://localhost:port/movies).

   Ha a következő hibaüzenet jelenik meg:

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

   Kihagyta a(z) lépést amigráció során.

2. Tesztelje az Új létrehozása hivatkozást.

   

   Note

   Előfordulhat, hogy nem tud tizedesvesszőt beírni a Price mezőbe. Ha támogatni szeretné jQuery-érvényesítési olyan nem angol nyelvű területi beállításokhoz, amelyek vesszőt (",") használnak tizedesvesszőhöz és nem US-English dátumformátumokhoz, az alkalmazást globalizálni kell. A globalizációval kapcsolatos utasításokért tekintse meg a ésGitHub-problémát.

3. Tesztelje a Szerkesztés, Részletekés Törlés hivatkozásokat.

A következő oktatóanyag az állványzatok által létrehozott fájlokat ismerteti.

A függőséginjektálással regisztrált környezet vizsgálata

ASP.NET Core a függőségek injektálásávalépül. A EF Core adatbázis-környezethez hasonló szolgáltatások függőséginjektálással vannak regisztrálva az alkalmazás indításakor. Az ilyen szolgáltatásokat igénylő összetevők (például Razor Oldalak) konstruktorparamétereken keresztül érhetők el. Az adatbázis-környezetpéldányt lekérő konstruktorkód később jelenik meg az oktatóanyagban.

Az állványzat-kezelő eszköz automatikusan létrehozott egy adatbázis-környezetet, és regisztrálta azt a függőséginjektálási tárolóban. Az állványzat a következő kiemelt kódot adja hozzá a Program.cs fájlhoz:

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

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/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.MapRazorPages();

app.Run();

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

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/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.MapStaticAssets();
app.MapRazorPages();

app.Run();

Hibaelhárítás a kész mintával

Ha olyan problémába ütközik, amely nem oldható meg, hasonlítsa össze a kódot a befejezett projektel. Befejezett projekt megtekintése vagy letöltése (hogyan lehet letölteni).

Következő lépések

Előző: Első lépésekKövetkező: Sablonozott Razor Oldalak