Del 2, lägg till en modell i en Razor Pages-app i ASP.NET Core

I den här självstudien har klasser lagts till för att hantera filmer i en databas. Appens modellklasser använder Entity Framework Core (EF Core) för att arbeta med databasen. EF Core är en objektrelationsmappare (O/RM) som förenklar dataåtkomsten. Du skriver modellklasserna först och EF Core skapar databasen.

Modellklasserna kallas POCO-klasser (från "Plain-Old CLR Objects") eftersom de inte har något beroende av EF Core. De definierar egenskaperna för de data som lagras i databasen.

Lägga till en datamodell

Visual Studio

1. I Solution Explorerhögerklickar du på projektet RazorPagesMovie>Lägg till>ny mapp. Ge mappen namnet Models.

2. Högerklicka på mappen Models. Välj Lägg till>class. Ge klassen namnet Movie.

3. Lägg till följande egenskaper i klassen 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; }
   }
   

Klassen Movie innehåller:

• Fältet ID krävs av databasen för den primära nyckeln.

• Ett [DataType] attribut som anger typen av data i egenskapen ReleaseDate. Med det här attributet:

  • Användaren behöver inte ange tidsinformation i datumfältet.
  • Endast datumet visas, inte tidsinformation.

• Frågetecknet efter string anger att egenskapen är null. För mer information, se nullbara referenstyper.

DataAnnotations behandlas i en senare handledning.

Skapa projektet för att kontrollera att det inte finns några kompileringsfel.

Visual Studio Code

1. Lägg till en mapp med namnet Models.
2. Lägg till en klass i mappen Models med namnet Movie.cs.

Lägg till följande egenskaper i klassen 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; }
}

Klassen Movie innehåller:

• Ett ID fält för att ange en primärnyckel för databasen.

• Ett [DataType] attribut för att ange typen av data i fältet ReleaseDate. Med det här attributet:

  • Användaren behöver inte ange tidsinformation i datumfältet.
  • Endast datumet visas, inte tidsinformation.

• Frågetecknet efter string anger att egenskapen är null. För mer information, se nullbara referenstyper.

DataAnnotations behandlas i en senare handledning.

Lägga till NuGet-paket och EF-verktyg

Kör följande .NET CLI-kommandon:

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

De föregående kommandona lägger till:

• CLI-verktygen (kommandoradsgränssnitt) för EF Core
• Verktyget aspnet-codegeneratorför scaffolding.
• Utforma tidsverktyg för EF Core
• EF Core SQLite-providern, som installerar EF Core-paketet som ett beroende.
• Paket som är nödvändiga för att skapa ramverk: Microsoft.VisualStudio.Web.CodeGeneration.Design och Microsoft.EntityFrameworkCore.SqlServer.

Vägledning om flera miljökonfigurationer som gör att en app kan konfigurera sina databaskontexter efter miljö finns i Använda flera miljöer i ASP.NET Core.

Not

Som standard representerar arkitekturen för de .NET-binärfiler som ska installeras den operativsystemarkitektur som körs. Information om hur du anger en annan operativsystemarkitektur finns i dotnet tool install, --arch option. Mer information finns i GitHub-problem dotnet/AspNetCore.Docs #29262.

I Visual Studio Code trycker du på Ctrl+F5 för att köra appen utan felsökning.

I panelen under redigeringsregionen väljer du fliken PROBLEM, eller på menyn Visa väljer du Problem om den inte visas för tillfället. Kontrollera att det inte finns några kompileringsfel.

Skapa filmmodellens struktur

I det här avsnittet skisseras filmmodellen. Det innebär att verktyget scaffolding skapar sidor för CRUD-åtgärder (Create, Read, Update och Delete) för filmmodellen.

Visual Studio

1. Skapa mappen Pages/Movies:

   1. Högerklicka på mappen Pages>Lägg till>ny mapp.
   2. Ge mappen namnet Movies.

2. Högerklicka på mappen Pages/Movies>Add>New Scaffolded Item.

   

3. I dialogrutan Lägg till ny scaffold väljer du Razor Sidor med hjälp av Entity Framework (CRUD)>Lägg till.

   

4. Slutför dialogrutan Lägg till Razor-sidor med hjälp av Entity Framework (CRUD):

   1. I listrutan Modellklass väljer du Film (RazorPagesMovie.Models).
   2. I raden Datakontextklass väljer du tecknet + (plus).
      1. I dialogrutan Lägg till datakontext genereras klassnamnet RazorPagesMovie.Data.RazorPagesMovieContext.
      2. I listrutan Databasprovider väljer du SQL Server.
   3. Välj Lägg till.

   

Filen appsettings.json uppdateras med anslutningssträngen som används för att ansluta till en lokal databas.

Visual Studio Code

• Öppna ett kommandogränssnitt till projektkatalogen som innehåller filerna Program.cs och .csproj. Kör följande kommando:

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

Följande tabell beskriver alternativen för ASP.NET Core-kodgeneratorn.

Alternativ	Beskrivning
-m	Namnet på modellen.
-dc	Den DbContext-klass som ska användas, inklusive namnrymd.
-udl	Använd standardlayouten.
-outDir	Sökvägen till den relativa utdatamappen för att skapa vyerna.
--referenceScriptLibraries	Lägger till _ValidationScriptsPartial på sidorna för redigering och skapande

Använd alternativet -h för att få hjälp med kommandot dotnet aspnet-codegenerator razorpage:

dotnet aspnet-codegenerator razorpage -h

Mer information finns i dotnet aspnet-codegenerator.

Använda SQLite för utveckling, SQL Server för produktion

När SQLite har valts är den mallgenererade koden redo för utveckling. Följande kod visar hur du väljer SQLite-anslutningssträngen under utveckling och SQL Server i produktion.

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

Föregående kod anropar inte UseDeveloperExceptionPage under utveckling eftersom WebApplication anropar UseDeveloperExceptionPage i utvecklingsläge.

Varning

Den här artikeln använder en lokal databas som inte kräver att användaren autentiseras. Produktionsappar bör använda det säkraste tillgängliga autentiseringsflödet. Mer information om autentisering för distribuerade test- och produktionsappar finns i Säkra autentiseringsflöden.

Filer som skapats och uppdaterats

Scaffold-processen skapar följande filer:

• Sidor/Filmer: Skapa, Ta bort, Detaljer, Redigera och Index.
• Data/RazorPagesMovieContext.cs

De skapade filerna förklaras i nästa handledning.

Scaffold-processen lägger till följande markerade kod i filen 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();

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

Ändringarna Program.cs beskrivs senare i den här handledningen.

Skapa det första databasschemat med EF:s migreringsfunktion

Migreringsfunktionen i Entity Framework Core är ett sätt att:

• Skapa det inledande databasschemat.
• Uppdatera databasschemat stegvis för att hålla det synkroniserat med appens datamodell. Befintliga data i databasen bevaras.

Visual Studio

I det här avsnittet används fönstret Package Manager Console (PMC) för att:

• Lägg till en inledande migrering.

• Uppdatera databasen med den första migreringen.

• På menyn Verktyg väljer du NuGet Package Manager>Package Manager Console.

  

• I PMC anger du följande kommando:

  Add-Migration InitialCreate
  

• Kommandot Add-Migration genererar kod för att skapa det första databasschemat. Schemat baseras på den modell som anges i DbContext. Argumentet InitialCreate används för att namnge migreringen. Valfritt namn kan användas, men enligt konventionen väljs ett namn som beskriver migreringen.

Följande varning visas, som åtgärdas i ett senare steg:

Ingen typ angavs för decimalkolumnen "Price" för entitetstypen "Film". Detta gör att värdena beskärs automatiskt om de inte får plats i standardprecisionen och skalan. Ange uttryckligen den SQL Server-kolumntyp som kan hantera alla värden med hjälp av "HasColumnType()".

• I PMC anger du följande kommando:

  Update-Database
  

  Kommandot Update-Database kör metoden Up i migreringar som inte har tillämpats. I det här fallet kör kommandot metoden Up i Migrations/<time-stamp>_InitialCreate.cs-filen, som skapar databasen.

Visual Studio Code

• Högerklicka på projektet RazorPagesMovie.csproj och välj sedan Öppna i integrerad terminal.

  Fönstret Terminal öppnas med kommandotolken i projektkatalogen, som innehåller filerna Program.cs och .csproj.

• Kör följande .NET CLI-kommando:

  dotnet ef migrations add InitialCreate
  

  Kommandot migrations genererar kod för att skapa det första databasschemat. Schemat baseras på den modell som anges i DbContext. Argumentet InitialCreate används för att namnge migreringarna. Valfritt namn kan användas, men enligt konventionen väljs ett namn som beskriver migreringen.

• Kör följande .NET CLI-kommando:

  dotnet ef database update
  

  Kommandot update kör metoden Up i migreringar som inte har tillämpats. I det här fallet kör update metoden Up i Migrations/<time-stamp>_InitialCreate.cs-filen, vilket skapar databasen.

Not

För SQLite anges kolumntypen för fältet Price till TEXT. Detta löses i ett senare steg.

Datakontexten RazorPagesMovieContext:

• Härleds från Microsoft.EntityFrameworkCore.DbContext.
• Anger vilka entiteter som ingår i datamodellen.
• Samordnar EF Core funktioner, till exempel Skapa, Läsa, Uppdatera och Ta bort, för Movie modellen.

Klassen RazorPagesMovieContext i filen Data/RazorPagesMovieContext.cssom genererades:

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

Föregående kod skapar egenskapen DbSet<Movie> för entitetsuppsättningen. I Entity Framework-terminologi motsvarar en entitetsuppsättning vanligtvis en databastabell. En entitet motsvarar en rad i tabellen.

Namnet på anslutningssträngen skickas till kontexten genom att anropa en metod i ett DbContextOptions-objekt. För lokal utveckling läser Konfigurationssystemet anslutningssträngen från appsettings.json-filen.

Testa appen

1. Kör appen och lägg till /Movies till URL:en i webbläsaren (http://localhost:port/movies).

   Om du får följande fel:

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

   Du missade migreringssteget.

2. Testa länken Skapa ny.

   

   Obs

   Du kanske inte kan ange decimaltecken i fältet Price. För att stödja jQuery-validering för språk som inte är engelska och som använder kommatecken (",") för en decimalpunkt och för datumformat som inte är US-English måste appen globaliseras. Globaliseringsinstruktioner finns i det här GitHub-problemet.

3. Testa länkarna Redigera, Detaljeroch Ta bort.

I nästa självstudie förklaras de filer som skapats med byggnadsställningar.

Granska kontexten som registrerats med beroendeinmatning

ASP.NET Core skapas med beroendeinjektion. Tjänster, till exempel EF Core databaskontext, registreras med beroendeinmatning när programmet startas. Komponenter som kräver dessa tjänster (till exempel Razor Pages) tillhandahålls via konstruktorparametrar. Konstruktorkoden som hämtar en databaskontextinstans visas senare i självstudien.

Verktyget scaffolding skapade automatiskt en databaskontext och registrerade den med containern för beroendeinmatning. Följande markerade kod läggs till i den Program.cs-filen av kodgeneratorn.

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

Felsökning med det slutförda exemplet

Om du stöter på ett problem som du inte kan lösa kan du jämföra koden med det slutförda projektet. Visa eller ladda ned slutfört projekt (hur du laddar ned).

Nästa steg

Föregående: Kom igångNästa: Autogenererade Razor sidor