Część 2. Dodawanie modelu do Razor aplikacji Pages w programie ASP.NET Core

W tym samouczku klasy są dodawane do zarządzania filmami w bazie danych. Klasy modeli aplikacji używają platformy Entity Framework Core (EF Core) do pracy z bazą danych. EF Core to maper obiektowo-relacyjny (O/RM), który upraszcza dostęp do danych. Najpierw piszesz klasy modeli i EF Core tworzy bazę danych.

Klasy modelu są znane jako klasy POCO (z "P lain-O ld CLR Objects"), ponieważ nie mają zależności od EF Core. Definiują właściwości danych przechowywanych w bazie danych.

Dodawanie modelu danych

Program Visual Studio

1. W Eksplorator rozwiązań kliknij prawym przyciskiem myszy projekt> RazorPagesProjekt Dodaj>nowy folder. Nadaj folderowi Modelsnazwę .

2. Kliknij prawym przyciskiem Models myszy folder. Wybierz pozycję Dodaj>klasę. Nadaj klasie nazwę Movie.

3. Dodaj następujące właściwości do Movie klasy:

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

Klasa Movie zawiera:

• Pole ID jest wymagane przez bazę danych dla klucza podstawowego.

• Atrybut [DataType], który określa typ danych we ReleaseDate właściwości. Za pomocą tego atrybutu:

  • Użytkownik nie musi wprowadzać informacji o godzinie w polu daty.
  • Wyświetlana jest tylko data, a nie informacje o godzinie.

• Znak zapytania po string wskazuje, że właściwość jest dopuszczana do wartości null. Aby uzyskać więcej informacji, zobacz Typy referencyjne dopuszczane do wartości null.

Adnotacje danych zostały omówione w późniejszym samouczku.

Skompiluj projekt, aby sprawdzić, czy nie ma błędów kompilacji.

Visual Studio Code

1. Dodaj folder o nazwie Models.
2. Dodaj klasę do Models folderu o nazwie Movie.cs.

Dodaj następujące właściwości do Movie klasy:

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

Klasa Movie zawiera:

• Pole ID do podania klucza podstawowego dla bazy danych.

• Atrybut [DataType] określający typ danych w ReleaseDate polu. Za pomocą tego atrybutu:

  • Użytkownik nie musi wprowadzać informacji o godzinie w polu daty.
  • Wyświetlana jest tylko data, a nie informacje o godzinie.

• Znak zapytania po string wskazuje, że właściwość jest dopuszczana do wartości null. Aby uzyskać więcej informacji, zobacz Typy referencyjne dopuszczane do wartości null.

Adnotacje danych zostały omówione w późniejszym samouczku.

Dodawanie pakietów NuGet i narzędzi EF

Uruchom następujące polecenia interfejsu wiersza polecenia platformy .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 --prerelease
dotnet add package Microsoft.EntityFrameworkCore.SQLite --prerelease
dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design --prerelease
dotnet add package Microsoft.EntityFrameworkCore.SqlServer --prerelease
dotnet add package Microsoft.EntityFrameworkCore.Tools --prerelease

Powyższe polecenia dodają:

• Narzędzia interfejsu wiersza polecenia (CLI) dla programu EF Core
• Narzędzie do tworzenia szkieletów aspnet-codegenerator.
• Narzędzia czasu projektowania dla programu EF Core
• EF Core Dostawca SQLite, który instaluje EF Core pakiet jako zależność.
• Pakiety potrzebne do tworzenia szkieletów: Microsoft.VisualStudio.Web.CodeGeneration.Design i Microsoft.EntityFrameworkCore.SqlServer.

Aby uzyskać wskazówki dotyczące wielu konfiguracji środowiska, które zezwala aplikacji na konfigurowanie kontekstów bazy danych według środowiska, zobacz Używanie wielu środowisk w programie ASP.NET Core.

Uwaga

Domyślnie architektura plików binarnych platformy .NET do zainstalowania reprezentuje obecnie uruchomioną architekturę systemu operacyjnego. Aby określić inną architekturę systemu operacyjnego, zobacz dotnet tool install, --arch option(Instalacja narzędzia dotnet). Aby uzyskać więcej informacji, zobacz problem z usługą GitHub dotnet/AspNetCore.Docs #29262.

W programie Visual Studio Code naciśnij Ctrl+F5 (Windows) lub ⌘+F5 (macOS), aby uruchomić aplikację bez debugowania.

W panelu poniżej regionu edytora wybierz kartę PROBLEMY lub z menu Widok wybierz pozycję Problemy, jeśli nie jest obecnie w widoku. Sprawdź, czy nie ma błędów kompilacji.

Tworzenie szkieletu modelu filmu

W tej sekcji model filmu jest szkieletowy. Oznacza to, że narzędzie tworzenia szkieletów tworzy strony dla operacji Tworzenia, odczytu, aktualizacji i usuwania (CRUD) dla modelu filmu.

Program Visual Studio

1. Utwórz folder Pages/Movies:

   1. Kliknij prawym przyciskiem myszy folder Pages Dodaj>nowy folder>.
   2. Nadaj folderowi nazwę Filmy.

2. Kliknij prawym przyciskiem myszy folder >Pages/Movies Dodaj>nowy element szkieletowy.

   

3. W oknie dialogowym Dodawanie nowego szkieletu wybierz pozycję Razor Strony przy użyciu programu Entity Framework (CRUD)>Dodaj.

   

4. Ukończ okno dialogowe Dodawanie Razor stron przy użyciu programu Entity Framework (CRUD):

   1. Z listy rozwijanej Klasa modelu wybierz pozycję Movie (RazorPagesFilm.Models).
   2. W wierszu Klasy kontekstu danych wybierz + znak (plus).
      1. W oknie dialogowym Dodawanie kontekstu danych jest generowana nazwa RazorPagesMovie.Data.RazorPagesMovieContext klasy.
      2. Z listy rozwijanej Dostawca bazy danych wybierz pozycję SQL Server.
   3. Wybierz Dodaj.

   

Plik appsettings.json jest aktualizowany przy użyciu parametry połączenia używanego do nawiązywania połączenia z lokalną bazą danych.

Visual Studio Code

• Otwórz powłokę poleceń w katalogu projektu zawierającym Program.cs pliki i .csproj . Uruchom następujące polecenie:

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

W poniższej tabeli przedstawiono opcje generatora kodu ASP.NET Core.

Opcja	Opis
-m	Nazwa modelu.
-dc	Klasa DbContext do użycia, w tym przestrzeń nazw.
-udl	Użyj układu domyślnego.
-outDir	Względna ścieżka folderu wyjściowego do utworzenia widoków.
--referenceScriptLibraries	Dodaje _ValidationScriptsPartial do edycji i tworzenia stron

-h Użyj opcji , aby uzyskać pomoc dotyczącą dotnet aspnet-codegenerator razorpage polecenia:

dotnet aspnet-codegenerator razorpage -h

Aby uzyskać więcej informacji, zobacz dotnet aspnet-codegenerator.

Używanie narzędzia SQLite do programowania, programu SQL Server dla środowiska produkcyjnego

Po wybraniu biblioteki SQLite wygenerowany kod jest gotowy do programowania. Poniższy kod pokazuje, jak wybrać parametry połączenia SQLite podczas programowania i programu SQL Server w środowisku produkcyjnym.

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

Powyższy kod nie wywołuje UseDeveloperExceptionPage w programowania, ponieważ WebApplication wywołuje je UseDeveloperExceptionPage w trybie programowania.

Ostrzeżenie

W tym artykule jest używana lokalna baza danych, która nie wymaga uwierzytelnienia użytkownika. Aplikacje produkcyjne powinny korzystać z najbezpieczniejszego dostępnego przepływu uwierzytelniania. Aby uzyskać więcej informacji na temat uwierzytelniania dla wdrożonych aplikacji testowych i produkcyjnych, zobacz Bezpieczne przepływy uwierzytelniania.

Pliki utworzone i zaktualizowane

Proces tworzenia szkieletu tworzy następujące pliki:

• Strony/filmy: tworzenie, usuwanie, szczegóły, edytowanie i indeks.
• Data/RazorPagesMovieContext.cs

Utworzone pliki zostały wyjaśnione w następnym samouczku.

Proces tworzenia szkieletu Program.cs dodaje do pliku następujący wyróżniony kod:

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

Zmiany Program.cs zostały wyjaśnione w dalszej części tego samouczka.

Tworzenie początkowego schematu bazy danych przy użyciu funkcji migracji ef

Funkcja migracji w programie Entity Framework Core umożliwia:

• Utwórz początkowy schemat bazy danych.
• Przyrostowe aktualizowanie schematu bazy danych w celu zachowania synchronizacji z modelem danych aplikacji. Istniejące dane w bazie danych są zachowywane.

Program Visual Studio

W tej sekcji okno konsoli Menedżer pakietów (PMC) służy do:

• Dodaj migrację początkową.

• Zaktualizuj bazę danych przy użyciu migracji początkowej.

• W menu Narzędzia wybierz pozycję NuGet Menedżer pakietów> Menedżer pakietów Konsola.

  

• W usłudze PMC wprowadź następujące polecenie:

  Add-Migration InitialCreate
  

• Polecenie Add-Migration generuje kod w celu utworzenia początkowego schematu bazy danych. Schemat jest oparty na modelu określonym w pliku DbContext. Argument InitialCreate służy do nazywania migracji. Można użyć dowolnej nazwy, ale zgodnie z konwencją wybrano nazwę opisjącą migrację.

Zostanie wyświetlone następujące ostrzeżenie, które zostało rozwiązane w późniejszym kroku:

Nie określono typu dla kolumny dziesiętnej "Price" w typie jednostki "Movie". Spowoduje to dyskretne obcięcie wartości, jeśli nie mieszczą się w domyślnej precyzji i skali. Jawnie określ typ kolumny serwera SQL, który może pomieścić wszystkie wartości przy użyciu polecenia "HasColumnType()".

• W usłudze PMC wprowadź następujące polecenie:

  Update-Database
  

  Polecenie Update-Database uruchamia metodę Up w migracjach, które nie zostały zastosowane. W takim przypadku polecenie uruchamia metodę Up w Migrations/<time-stamp>_InitialCreate.cs pliku , która tworzy bazę danych.

Visual Studio Code

• Kliknij prawym przyciskiem myszy projekt RazorPagesFilm.csproj , a następnie wybierz polecenie Otwórz w zintegrowanym terminalu.

  Zostanie otwarte okno terminalu z wierszem polecenia w katalogu projektu zawierającym pliki Program.cs i csproj.

• Uruchom następujące polecenie interfejsu wiersza polecenia platformy .NET:

  dotnet ef migrations add InitialCreate
  

  Polecenie migrations generuje kod w celu utworzenia początkowego schematu bazy danych. Schemat jest oparty na modelu określonym w pliku DbContext. Argument InitialCreate służy do nazywania migracji. Można użyć dowolnej nazwy, ale zgodnie z konwencją wybrano nazwę opisjącą migrację.

• Uruchom następujące polecenie interfejsu wiersza polecenia platformy .NET:

  dotnet ef database update
  

  Polecenie update uruchamia metodę Up w migracjach, które nie zostały zastosowane. W takim przypadku update uruchamia metodę Up w Migrations/<time-stamp>_InitialCreate.cs pliku, która tworzy bazę danych.

Uwaga

W przypadku biblioteki SQLite typ kolumny Price dla pola ma wartość TEXT. Ten problem zostanie rozwiązany w późniejszym kroku.

Kontekst RazorPagesMovieContextdanych:

• Pochodzi z Microsoft.EntityFrameworkCore.DbContext.
• Określa, które jednostki są uwzględnione w modelu danych.
• Koordynuje EF Core funkcje, takie jak Tworzenie, Odczyt, Aktualizowanie i Usuwanie dla Movie modelu.

Klasa RazorPagesMovieContext w wygenerowany plik 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!;
    }
}

Powyższy kod tworzy właściwość DbSet<Movie> dla zestawu jednostek. W terminologii platformy Entity Framework zestaw jednostek zwykle odpowiada tabeli bazy danych. Jednostka odpowiada wierszowi w tabeli.

Nazwa parametry połączenia jest przekazywana do kontekstu przez wywołanie metody w obiekcie DbContextOptions. W przypadku programowania lokalnego system konfiguracji odczytuje parametry połączenia z appsettings.json pliku.

Testowanie aplikacji

1. Uruchom aplikację i dołącz /Movies go do adresu URL w przeglądarce (http://localhost:port/movies).

   Jeśli wystąpi następujący błąd:

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

   Krok migracji został pominięty.

2. Przetestuj link Utwórz nowy .

   

   Uwaga

   W polu może nie być możliwe wprowadzenie przecinków dziesiętnych Price . Aby obsługiwać walidację jQuery dla ustawień regionalnych innych niż angielski, które używają przecinka (",") dla punktu dziesiętnego i w formatach dat innych niż angielskie stany USA, aplikacja musi zostać zglobalizowana. Aby uzyskać instrukcje dotyczące globalizacji, zobacz ten problem z usługą GitHub.

3. Przetestuj linki Edytuj, Szczegóły i Usuń.

W następnym samouczku wyjaśniono pliki utworzone przez tworzenie szkieletów.

Badanie kontekstu zarejestrowanego za pomocą iniekcji zależności

ASP.NET Core jest kompilowany za pomocą wstrzykiwania zależności. Usługi, takie jak EF Core kontekst bazy danych, są rejestrowane za pomocą wstrzykiwania zależności podczas uruchamiania aplikacji. Składniki, które wymagają tych usług (takich jak Razor Pages), są udostępniane za pomocą parametrów konstruktora. Kod konstruktora, który pobiera wystąpienie kontekstu bazy danych, jest wyświetlany w dalszej części samouczka.

Narzędzie do tworzenia szkieletów automatycznie utworzyło kontekst bazy danych i zarejestrowało je w kontenerze wstrzykiwania zależności. Następujący wyróżniony kod jest dodawany do Program.cs pliku przez szkielet:

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

Rozwiązywanie problemów z ukończonym przykładem

Jeśli napotkasz problem, nie możesz go rozwiązać, porównaj kod z ukończonym projektem. Wyświetl lub pobierz ukończony projekt (jak pobrać).

Następne kroki

Poprzedni: Rozpocznijdalej: strony szkieletowe Razor