Část 2: Přidání modelu do Razor aplikace Pages v ASP.NET Core

V tomto kurzu se přidávají třídy pro správu filmů v databázi. Třídy modelu aplikace používají Entity Framework Core (EF Core) k práci s databází. EF Core je objektově-relační mapovač (O/RM), který zjednodušuje přístup k datům. Nejprve napíšete třídy modelu a EF Core vytvoříte databázi.

Třídy modelu se označují jako třídy POCO (z "P lain-O ld C LR Objects"), protože nemají závislost na EF Core. Definují vlastnosti dat uložených v databázi.

Přidání datového modelu

Visual Studio

1. V Průzkumník řešení klikněte pravým tlačítkem myši naRazor projekt >PagesMovie Přidat>novou složku. Pojmenujte složku Models.

2. Klikněte pravým tlačítkem myši na Models složku. Vyberte Přidat>třídu. Pojmenujte třídu Movie.

3. Do třídy přidejte následující vlastnosti Movie :

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

Třída Movie obsahuje:

• Pole ID vyžaduje databáze pro primární klíč.

• Atribut [DataType], který určuje typ dat v ReleaseDate vlastnosti. S tímto atributem:

  • Uživatel nemusí do pole kalendářního data zadávat informace o čase.
  • Zobrazí se pouze datum, nikoli informace o čase.

• Otazník po string značí, že vlastnost je nullable. Další informace naleznete v tématu Odkazové typy s možnou hodnotou Null.

Poznámky k datům jsou popsané v pozdějším kurzu.

Sestavte projekt, abyste ověřili, že nedošlo k žádným chybám kompilace.

Visual Studio Code

1. Přidejte složku s názvem Models.
2. Přidejte třídu do Models složky s názvem Movie.cs.

Do třídy přidejte následující vlastnosti Movie :

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

Třída Movie obsahuje:

• Pole ID pro zadání primárního klíče pro databázi.

• Atribut [DataType] určující typ dat v ReleaseDate poli. S tímto atributem:

  • Uživatel nemusí do pole data zadávat informace o čase.
  • Zobrazí se pouze datum, nikoli informace o čase.

• Otazník po string značí, že vlastnost je nullable. Další informace naleznete v tématu Odkazové typy s možnou hodnotou Null.

Poznámky k datům jsou popsané v pozdějším kurzu.

Přidání balíčků NuGet a nástrojů EF

Spusťte následující příkazy rozhraní příkazového řádku .NET:

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

Předchozí příkazy přidávají:

• Nástroje rozhraní příkazového řádku (CLI) proEF Core
• Nástroj pro generování uživatelského rozhraní aspnet-codegenerator.
• Nástroje pro čas návrhu pro EF Core
• EF Core Zprostředkovatel SQLite, který nainstaluje EF Core balíček jako závislost.
• Balíčky potřebné pro generování uživatelského rozhraní: Microsoft.VisualStudio.Web.CodeGeneration.Design a Microsoft.EntityFrameworkCore.SqlServer.

Pokyny k více konfiguracím prostředí, které aplikaci umožňují konfigurovat kontexty databáze podle prostředí, najdete v tématu Použití více prostředí v ASP.NET Core.

Poznámka:

Ve výchozím nastavení architektura binárních souborů .NET, které se mají nainstalovat, představuje aktuálně spuštěnou architekturu operačního systému. Pokud chcete zadat jinou architekturu operačního systému, přečtěte si téma instalace nástroje dotnet, možnost --arch. Další informace najdete v tématu o problému GitHubu dotnet/AspNetCore.Docs #29262.

V editoru Visual Studio Code stisknutím kláves Ctrl+F5 (Windows) nebo ⌘+F5 (macOS) spusťte aplikaci bez ladění.

Na panelupod oblastí editoru vyberte kartu PROBLÉMY nebo v nabídce Zobrazení vyberte Problémy, pokud aktuálně není v zobrazení. Ověřte, že nedošlo k žádným chybám kompilace.

Visual Studio pro Mac

1. V okně Nástroje řešení klikněte na projekt PagesMovie a Razorpak vyberte Přidat>novou složku.... Pojmenujte složku Models.

2. Control-click the Models folder, and then select Add>New Class....

3. V dialogovém okně Nový soubor :

   1. V levém podokně vyberte Obecné .
   2. V prostředním podokně vyberte prázdnou třídu .
   3. Pojmenujte video třídy a vyberte Vytvořit.

4. Do třídy přidejte následující vlastnosti Movie :

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

Třída Movie obsahuje:

• Pole ID pro zadání primárního klíče pro databázi.

• Atribut [DataType] určující typ dat v ReleaseDate poli. S tímto atributem:

  • Uživatel nemusí do pole kalendářního data zadávat informace o čase.
  • Zobrazí se pouze datum, nikoli informace o čase.

Poznámky k datům jsou popsané v pozdějším kurzu.

Sestavte projekt, abyste ověřili, že nedošlo k žádným chybám kompilace.

Generování uživatelského rozhraní modelu filmu

V této části se model filmu vygeneruje. To znamená, že nástroj pro generování uživatelského rozhraní vytváří stránky pro operace Create, Read, Update a Delete (CRUD) pro model filmu.

Visual Studio

1. Vytvořte složku Pages/Movies:

   1. Klikněte pravým tlačítkem myši na složku >Stránky Přidat>novou složku.
   2. Pojmenujte složku Filmy.

2. Klikněte pravým tlačítkem myši na složku >Stránky/Filmy Přidat>novou vygenerovanou položku.

   

3. V dialogovém okně Přidat nové generování uživatelského rozhraní vyberte Razor Stránky pomocí entity Framework (CRUD)>Přidat.

   

4. Dokončete dialogové okno Přidat Razor stránky pomocí entity Framework (CRUD):

   1. V rozevíracím seznamu Třída modelu vyberte Movie (RazorPagesMovie.Models).
   2. V řádku třídy kontextu dat vyberte znaménko + (plus).
      1. V dialogovém okně Přidat kontext dat se vygeneruje název RazorPagesMovie.Data.RazorPagesMovieContext třídy.
      2. V rozevíracím seznamu Poskytovatel databáze vyberte SQL Server.
   3. Vyberte Přidat.

   

Soubor appsettings.json se aktualizuje pomocí připojovací řetězec sloužící k připojení k místní databázi.

Visual Studio Code

• Otevřete příkazové prostředí pro adresář projektu, který obsahuje soubory Program.cs a .csproj soubory. Spusťte následující příkaz:

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

Následující tabulka obsahuje podrobnosti o možnostech generátoru kódu ASP.NET Core.

Možnost	Popis
-m	Název modelu
-dc	Třída DbContext , která se má použít včetně oboru názvů.
-udl	Použijte výchozí rozložení.
-outDir	Relativní cesta k výstupní složce pro vytvoření zobrazení.
--referenceScriptLibraries	Přidá _ValidationScriptsPartial stránky pro úpravy a vytváření.

-h Pomocí možnosti získat nápovědu k dotnet aspnet-codegenerator razorpage příkazu:

dotnet aspnet-codegenerator razorpage -h

Další informace naleznete v tématu dotnet aspnet-codegenerator.

Použití SQLite pro vývoj, SQL Server pro produkční prostředí

Když vyberete SQLite, je vygenerovaný kód šablony připravený pro vývoj. Následující kód ukazuje, jak vybrat připojovací řetězec SQLite ve vývoji a SQL Serveru v produkčním prostředí.

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

Předchozí kód ve vývoji nevolá UseDeveloperExceptionPage , protože WebApplication volání UseDeveloperExceptionPage ve vývojovém režimu.

Visual Studio pro Mac

1. Přidejte balíček Microsoft.EntityFrameworkCore.SqliteNuGet, který je nutný pro nástroj pro generování uživatelského rozhraní.

   1. V okně Nástroje řešení klikněte na projekt PagesMovie a Razorpak vyberte Otevřít v terminálu.

   Otevře se okno Terminálu s příkazovým řádkem v adresáři projektu, který obsahuje soubory Program.cs a .csproj.

   1. Spusťte následující příkaz rozhraní příkazového řádku .NET:

     dotnet add package Microsoft.EntityFrameworkCore.SQLite
   

2. Vytvořte složku Pages/Movies:

   1. Control-click on the Pages folder >Add>New Folder.
   2. Pojmenujte složku Filmy.

3. Control-click on the Pages/Movies folder >Add>New Scaffolding....

   

4. V dialogovém okně Nové generování uživatelského rozhraní vyberte Razor Stránky využívající Entity Framework (CRUD)>Další.

   

5. Dokončete dialogové okno Přidat Razor stránky pomocí entity Framework (CRUD):

   1. Do třídy Model použít: řádek, zadejte Movie.
   2. V DbContext Třídy použít: řádek pojmenujte třídu RazorPagesMovie.Data.RazorPagesMovieContext.
   3. Vyberte Dokončit.

   

Dokončení procesu generování uživatelského rozhraní může chvíli trvat, protože požadované balíčky se automaticky stáhnou a přidají do projektu.

Soubor appsettings.json se aktualizuje pomocí připojovací řetězec sloužící k připojení k místní databázi.

Použití SQLite pro vývoj, SQL Server pro produkční prostředí

Když vyberete SQLite, je vygenerovaný kód šablony připravený pro vývoj. Následující kód ukazuje, jak vybrat připojovací řetězec SQLite ve vývoji a SQL Serveru v produkčním prostředí.

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

Předchozí kód ve vývoji nevolá UseDeveloperExceptionPage , protože WebApplication volání UseDeveloperExceptionPage ve vývojovém režimu.

Soubory vytvořené a aktualizované

Proces generování uživatelského rozhraní vytvoří následující soubory:

• Stránky/filmy: Vytváření, odstraňování, podrobnosti, úpravy a index.
• Data/RazorPagesMovieContext.cs

Vytvořené soubory jsou vysvětleny v dalším kurzu.

Vygenerovaný proces přidá do Program.cs souboru následující zvýrazněný kód:

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

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

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

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

app.Run();

Změny Program.cs jsou vysvětleny dále v tomto kurzu.

Vytvoření počátečního schématu databáze pomocí funkce migrace EF

Funkce migrace v Entity Framework Core nabízí způsob, jak:

• Vytvořte počáteční schéma databáze.
• Přírůstkově aktualizujte schéma databáze, aby bylo synchronizované s datovým modelem aplikace. Existující data v databázi se zachovají.

Visual Studio

V této části se okno konzoly Správce balíčků (PMC) používá k:

• Přidejte počáteční migraci.
• Aktualizujte databázi počáteční migrací.

1. V nabídce Nástroje vyberte Správce balíčků> NuGet Správce balíčků Konzola.

   

2. V PMC zadejte následující příkazy:

   Add-Migration InitialCreate
   Update-Database
   

• Příkaz Add-Migration vygeneruje kód pro vytvoření počátečního schématu databáze. Schéma je založeno na modelu zadaném v DbContext. Argument InitialCreate se používá k pojmenování migrace. Libovolný název lze použít, ale podle konvence je vybraný název, který popisuje migraci.

• Příkaz Update-Database spustí metodu Up v migracích, které nebyly použity. V tomto případě příkaz spustí metodu UpMigrations/<time-stamp>_InitialCreate.cs v souboru, která vytvoří databázi.

Visual Studio Code

• Klikněte pravým tlačítkem myši na Razorprojekt PagesMovie.csproj a pak vyberte Otevřít v integrovaném terminálu.

  Otevře se okno terminálu s příkazovým řádkem v adresáři projektu, který obsahuje soubory Program.cs a .csproj.

• Spusťte následující příkazy rozhraní příkazového řádku .NET:

  dotnet ef migrations add InitialCreate
  dotnet ef database update
  

• Příkaz migrations vygeneruje kód pro vytvoření počátečního schématu databáze. Schéma je založeno na modelu zadaném v DbContext. Argument InitialCreate se používá k pojmenování migrací. Libovolný název lze použít, ale podle konvence je vybraný název, který popisuje migraci.

• Příkaz update spustí metodu Up v migracích, které nebyly použity. V tomto případě update spustí metodu UpMigrations/<time-stamp>_InitialCreate.cs v souboru, která vytvoří databázi.

Poznámka:

Pro SQLite je typ sloupce pro Price pole nastaven na TEXThodnotu . Tento problém se vyřeší v pozdějším kroku.

Visual Studio pro Mac

• Control-click the RazorPagesMovie project, and then select Open in Terminal.

  Otevře se okno terminálu s příkazovým řádkem v adresáři projektu, který obsahuje soubory Program.cs a .csproj.

• Spusťte následující příkazy rozhraní příkazového řádku .NET:

  dotnet tool uninstall --global dotnet-ef
  dotnet tool install --global dotnet-ef
  dotnet ef migrations add InitialCreate
  dotnet ef database update
  

• Příkazy tool nainstalují nejnovější nástroje Entity Framework Core po odinstalaci jakékoli předchozí verze, pokud existuje.

  Poznámka:

  Ve výchozím nastavení architektura binárních souborů .NET, které se mají nainstalovat, představuje aktuálně spuštěnou architekturu operačního systému. Pokud chcete zadat jinou architekturu operačního systému, přečtěte si téma instalace nástroje dotnet, možnost --arch. Další informace najdete v tématu o problému GitHubu dotnet/AspNetCore.Docs #29262.

• Příkaz migrations vygeneruje kód pro vytvoření počátečního schématu databáze. Schéma je založeno na modelu zadaném v DbContext. Argument InitialCreate se používá k pojmenování migrací. Libovolný název lze použít, ale podle konvence je vybraný název, který popisuje migraci.

• Příkaz update spustí metodu Up v migracích, které nebyly použity. V tomto případě update spustí metodu UpMigrations/<time-stamp>_InitialCreate.cs v souboru, která vytvoří databázi.

Poznámka:

Pro SQLite je typ sloupce pro Price pole nastaven na TEXThodnotu . Tento problém se vyřeší v pozdějším kroku.

Zobrazí se následující upozornění, které je vyřešeno v pozdějším kroku:

Pro desetinný sloupec Price pro typ entity Movie nebyl zadán žádný typ. To způsobí, že se hodnoty bezobslužně zkrátí, pokud se nevejdou do výchozí přesnosti a měřítka. Explicitně zadejte typ sloupce serveru SQL, který může obsahovat všechny hodnoty pomocí hasColumnType().

Kontext RazorPagesMovieContextdat:

• Odvozuje z Microsoft.EntityFrameworkCore.DbContext.
• Určuje, které entity jsou součástí datového modelu.
• Koordinuje EF Core funkce, jako je Vytvoření, Čtení, Aktualizace a Odstranění, pro Movie model.

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!;
    }
}

Předchozí kód vytvoří vlastnost DbSet<Movie> pro sadu entit. V terminologii Entity Framework sada entit obvykle odpovídá databázové tabulce. Entita odpovídá řádku v tabulce.

Název připojovací řetězec se předává kontextu voláním metody na DbContextOptions objektu. Pro místní vývoj načte konfigurační systém připojovací řetězec ze appsettings.json souboru.

Otestování aplikace

1. Spusťte aplikaci a připojte /Movies se k adrese URL v prohlížeči (http://localhost:port/movies).

   Pokud se zobrazí následující chyba:

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

   Zmeškali jste krok migrace.

2. Otestujte odkaz Vytvořit nový .

   

   Poznámka:

   Do pole pravděpodobně nebudete moct zadávat desetinné čárky Price . Aby bylo možné podporovat ověřování jQuery pro neanglické národní prostředí, které používají čárku (",") pro desetinnou čárku a pro jiné formáty kalendářních dat než v ANGLIČTINĚ, musí být aplikace globalizována. Pokyny ke globalizaci najdete v tomto problému na GitHubu.

3. Otestujte odkazy Upravit, Podrobnosti a Odstranit.

Další kurz vysvětluje soubory vytvořené generováním uživatelského rozhraní.

Prozkoumání kontextu registrovaného pomocí injektáže závislostí

ASP.NET Core se sestavuje pomocí injektáže závislostí. Služby, jako EF Core je kontext databáze, se během spouštění aplikace registrují pomocí injektáže závislostí. Komponenty, které vyžadují tyto služby (například Razor Stránky), jsou poskytovány prostřednictvím parametrů konstruktoru. Kód konstruktoru, který získá instanci kontextu databáze, se zobrazí později v kurzu.

Nástroj pro generování uživatelského rozhraní automaticky vytvořil kontext databáze a zaregistroval ho v kontejneru injektáže závislostí. Do souboru se přidá Program.cs následující zvýrazněný kód správcem:

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

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

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

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

app.Run();

Řešení potíží s dokončenou ukázkou

Pokud narazíte na problém, který nemůžete vyřešit, porovnejte kód s dokončeným projektem. Zobrazit nebo stáhnout dokončený projekt (jak stáhnout)

Další kroky

Předchozí: Další začínáme: Vygenerované Razor stránky