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

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.

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 det möjligt för en app att konfigurera sina databaskontexter efter miljö finns i ASP.NET Core-körningsmiljöer.

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.

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.

• Ö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.

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.

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

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

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.

• 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.

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

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

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.

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 det möjligt för en app att konfigurera sina databaskontexter efter miljö finns i ASP.NET Core-körningsmiljöer.

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.

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.

• Ö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.

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.

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

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

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.

• 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.

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

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

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.

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 det möjligt för en app att konfigurera sina databaskontexter efter miljö finns i ASP.NET Core-körningsmiljöer.

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.

1. I fönstret lösningsverktygkontroll-klickar du på RazorPagesMovie-projektet och väljer sedan Lägg till>ny mapp.... Ge mappen namnet Models.

2. Kontrollera och klicka på mappen Models och välj sedan Lägg till>ny klass....

3. I dialogrutan Ny fil:

   1. Välj Allmänt i den vänstra rutan.
   2. Välj Tom klass i mittenfönstret.
   3. Ge klassen namnet Movie och välj Skapa.

4. 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.

DataAnnotations behandlas i en senare handledning.

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

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.

• Ö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.

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.

1. Lägg till NuGet-paketet Microsoft.EntityFrameworkCore.Sqlite, som krävs för verktyget scaffolding.

   1. I lösningsverktygsfönstret, kontroll-klicka på RazorPagesMovie-projektet och välj sedan Öppna i Terminal.

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

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

     dotnet add package Microsoft.EntityFrameworkCore.SQLite
   

2. Skapa en -mapp för sidor och filmer:

   1. Kontrollera och klicka på mappen Pages>Lägg till>ny mapp.
   2. Ge mappen namnet Movies.

3. Kontroll-klicka på mappen Pages/Movies>Add>New Scaffolding....

   

4. I dialogrutan New Scaffolding väljer du Razor Pages using Entity Framework (CRUD)>Next.

   

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

   1. I modelklassen , använd: rad, skriv in Movie.
   2. I den DbContext-klass som ska användas: rad namnger du klassen RazorPagesMovie.Data.RazorPagesMovieContext.
   3. Välj Slutför.

   

Det kan ta lite tid att slutföra scaffolding-processen eftersom nödvändiga paket laddas ned automatiskt och läggs till i projektet.

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

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.

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

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

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.

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

   

2. I PMC anger du följande kommandon:

   Add-Migration InitialCreate
   Update-Database
   

• 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.

• 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.

• 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-kommandon:

  dotnet ef migrations add InitialCreate
  dotnet ef database update
  

• 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.

• 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.

• Kontrollera och klicka på projektet RazorPagesMovie och välj sedan Öppna i Terminal.

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

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

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

• tool-kommandona installerar de senaste Entity Framework Core-verktygen efter att ha avinstallerat någon tidigare version, om det finns en sådan.

  Note

  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.

• 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.

• 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.

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

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

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; } = string.Empty;
   
           [DataType(DataType.Date)]
           public DateTime ReleaseDate { get; set; }
           public string Genre { get; set; } = string.Empty;
           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.

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; } = string.Empty;

        [DataType(DataType.Date)]
        public DateTime ReleaseDate { get; set; }
        public string Genre { get; set; } = string.Empty;
        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.

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

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 det möjligt för en app att konfigurera sina databaskontexter efter miljö finns i ASP.NET Core-körningsmiljöer.

1. Högerklicka på projektet RazorPagesMovie i Solution Tool-fönstretoch välj sedan Lägg till>ny mapp.... Ge mappen namnet Models.

2. Högerklicka på mappen Models och välj sedan Lägg till>ny fil....

3. I dialogrutan Ny fil:

   1. Välj Allmänt i den vänstra rutan.
   2. Välj Tom klass i mittenfönstret.
   3. Ge klassen namnet Movie och välj Skapa.

4. 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; } = string.Empty;
   
           [DataType(DataType.Date)]
           public DateTime ReleaseDate { get; set; }
           public string Genre { get; set; } = string.Empty;
           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.

1. Lägg till NuGet-paketet Microsoft.EntityFrameworkCore.Design, som krävs för verktyget scaffolding.

   1. På menyn Verktyg väljer du NuGet Package Manager>Manage NuGet Packages for Solution
   2. Välj fliken Bläddra.
   3. Ange Microsoft.EntityFrameworkCore.Design och välj den i listan.
   4. Kontrollera Project och välj sedan Installera
   5. Välj Jag accepterar i dialogrutan Licensgodkännande.

2. Skapa mappen Pages/Movies:

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

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

   

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

   

5. 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.
   3. Välj Lägg till.

   

   Om du får ett felmeddelande som säger att du behöver installera Microsoft.EntityFrameworkCore.SqlServer-paketet, upprepa stegen med början från Lägg till>Nytt stödobjekt.

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

• Ö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 RazorPagesMovieContext -udl -outDir Pages/Movies --referenceScriptLibraries -sqlite
  

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

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.

1. Skapa en -mapp för sidor och filmer:

   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 Scaffolding....

   

3. I dialogrutan New Scaffolding väljer du Razor Pages using Entity Framework (CRUD)>Next.

   

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

   1. I modelklassen , använd: rad, skriv in Movie.
   2. I den DbContext-klass som ska användas: rad namnger du klassen RazorPagesMovie.Data.RazorPagesMovieContext.
   3. Välj Slutför.

   

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

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.

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

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

app.Run();

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.

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

   

2. I PMC anger du följande kommandon:

   Add-Migration InitialCreate
   Update-Database
   
   

• Högerklicka på projektet RazorPagesMovie i Solution Tool-fönstretoch välj sedan Öppna i Terminal.

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

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

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

  Note

  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.

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

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

app.Run();

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

• [DataType(DataType.Date)]: [DataType]-attributet anger datatypen (Date). Med det här attributet:

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

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

• [DataType(DataType.Date)]: [DataType]-attributet anger datatypen (Date). Med det här attributet:

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

Lägga till NuGet-paket och EF-verktyg

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

dotnet tool install --global dotnet-ef
dotnet tool install --global dotnet-aspnet-codegenerator
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

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 det möjligt för en app att konfigurera sina databaskontexter efter miljö finns i ASP.NET Core-körningsmiljöer.

Om du får ett genereringsfel kontrollerar du att Target Framework Moniker (TFM) matchar NuGet-paketversionen i projektfilen. Följande projektfil använder till exempel version 5.0 för .NET och de nuget-paket som visas:

<Project Sdk="Microsoft.NET.Sdk.Web">

  <PropertyGroup>
    <TargetFramework>net5.0</TargetFramework>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.AspNetCore.Diagnostics.EntityFrameworkCore" Version="5.0.0-*" />
    <PackageReference Include="Microsoft.AspNetCore.Identity.EntityFrameworkCore" Version="5.0.0-*" />
    <PackageReference Include="Microsoft.AspNetCore.Identity.UI" Version="5.0.0-*" />
    <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="5.0.0-*" />
    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="5.0.0-*" />
    <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="5.0.0-*" />
    <PackageReference Include="Microsoft.VisualStudio.Web.CodeGeneration.Design" Version="5.0.0-*" />
  </ItemGroup>

</Project>

1. I fönstret lösningsverktygkontroll-klickar du på RazorPagesMovie-projektet och väljer sedan Lägg till>ny mapp.... Ge mappen namnet Models.

2. Kontrollera och klicka på mappen Models och välj sedan Lägg till>ny fil....

3. I dialogrutan Ny fil:

   1. Välj Allmänt i den vänstra rutan.
   2. Välj Tom klass i mittenfönstret.
   3. Ge klassen namnet Movie och välj Ny.

4. Lägg till följande egenskaper i klassen Movie:

   using System;
   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.

• [DataType(DataType.Date)]: [DataType]-attributet anger datatypen (Date). Med det här attributet:

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

1. Skapa en -mapp för sidor och filmer:

   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 väljer du Razor sidor med 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.
   3. Välj Lägg till.

   

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

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

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

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

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 matar in IWebHostEnvironment i Startup. IWebHostEnvironment matas in så att ConfigureServices kan använda SQLite i utveckling och SQL Server i produktion.

public class Startup
{
    public Startup(IConfiguration configuration, IWebHostEnvironment env)
    {
        Environment = env;
        Configuration = configuration;
    }

    public IConfiguration Configuration { get; }
    public IWebHostEnvironment Environment { get; }

    public void ConfigureServices(IServiceCollection services)
    {
        if (Environment.IsDevelopment())
        {
            services.AddDbContext<RazorPagesMovieContext>(options =>
            options.UseSqlite(
                Configuration.GetConnectionString("RazorPagesMovieContext")));
        }
        else
        {
            services.AddDbContext<RazorPagesMovieContext>(options =>
            options.UseSqlServer(
                Configuration.GetConnectionString("MovieContext")));
        }

        services.AddRazorPages();
    }

    public void Configure(IApplicationBuilder app)
    {
        if (Environment.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
        }
        else
        {
            app.UseExceptionHandler("/Error");
            app.UseHsts();
        }

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

        app.UseRouting();

        app.UseEndpoints(endpoints =>
        {
            endpoints.MapRazorPages();
        });
    }
}

1. Skapa en -mapp för sidor och filmer:

   1. Kontrollera och klicka på mappen Pages>Lägg till>ny mapp.
   2. Ge mappen namnet Movies.

2. Kontroll-klicka på mappen Pages/Movies>Add>New Scaffolding....

   

3. I dialogrutan New Scaffolding väljer du Razor Pages using Entity Framework (CRUD)>Next.

   

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

   1. I den DbContext-klass som ska användas: rad namnger du klassen RazorPagesMovie.Data.RazorPagesMovieContext.
   2. Välj Slutför.

   

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

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 matar in IWebHostEnvironment i Startup. IWebHostEnvironment matas in så att ConfigureServices kan använda SQLite i utveckling och SQL Server i produktion.

public class Startup
{
    public Startup(IConfiguration configuration, IWebHostEnvironment env)
    {
        Environment = env;
        Configuration = configuration;
    }

    public IConfiguration Configuration { get; }
    public IWebHostEnvironment Environment { get; }

    public void ConfigureServices(IServiceCollection services)
    {
        if (Environment.IsDevelopment())
        {
            services.AddDbContext<RazorPagesMovieContext>(options =>
            options.UseSqlite(
                Configuration.GetConnectionString("RazorPagesMovieContext")));
        }
        else
        {
            services.AddDbContext<RazorPagesMovieContext>(options =>
            options.UseSqlServer(
                Configuration.GetConnectionString("MovieContext")));
        }

        services.AddRazorPages();
    }

    public void Configure(IApplicationBuilder app)
    {
        if (Environment.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
        }
        else
        {
            app.UseExceptionHandler("/Error");
            app.UseHsts();
        }

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

        app.UseRouting();

        app.UseEndpoints(endpoints =>
        {
            endpoints.MapRazorPages();
        });
    }
}

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.

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

   

2. I PMC anger du följande kommandon:

   Add-Migration InitialCreate
   Update-Database
   

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

  dotnet ef migrations add InitialCreate
  dotnet ef database update
  

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.

Granska metoden Startup.ConfigureServices. Den markerade linjen har lagts till av ställningsbyggaren:

public void ConfigureServices(IServiceCollection services)
{
    services.AddRazorPages();

    services.AddDbContext<RazorPagesMovieContext>(options =>
      options.UseSqlServer(Configuration.GetConnectionString("RazorPagesMovieContext")));
}

RazorPagesMovieContext samordnar EF Core funktioner, till exempel Skapa, Läsa, Uppdatera och Ta bort, för Movie modellen. Datakontexten (RazorPagesMovieContext) härleds från Microsoft.EntityFrameworkCore.DbContext. Datakontexten anger vilka entiteter som ingår i datamodellen.

using Microsoft.EntityFrameworkCore;

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

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

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.

Granska metoden Up.

Högerklicka på projektet RazorPagesMovie>Lägg till>ny mapp. Ge mappen namnet Models.

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

Lägg till följande egenskaper i klassen Movie:

using System;
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.

• [DataType(DataType.Date)]: Attributet DataType specificerar typen av data (Date). Med det här attributet:

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

DataAnnotations behandlas i en senare handledning.

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

Lägg till följande egenskaper i klassen Movie:

using System;
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.

• [DataType(DataType.Date)]: Attributet DataType specificerar typen av data (Date). Med det här attributet:

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

DataAnnotations behandlas i en senare handledning.

Lägga till NuGet-paket och EF-verktyg

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

dotnet tool install --global dotnet-ef --version 3.1.9
dotnet tool install --global dotnet-aspnet-codegenerator --version 3.1.4
dotnet add package Microsoft.EntityFrameworkCore.Sqlite --version 3.1.9
dotnet add package Microsoft.AspNetCore.Diagnostics.EntityFrameworkCore --version 3.1.9
dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design --version 3.1.4
dotnet add package Microsoft.EntityFrameworkCore.Design --version 3.1.9
dotnet add package Microsoft.EntityFrameworkCore.SqlServer --version 3.1.9
dotnet add package Microsoft.Extensions.Logging.Debug --version 3.1.9

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

• Verktyget aspnet-codegeneratorför scaffolding.
• Verktyg för Entity Framework Core i .NET CLI.
• 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 det möjligt för en app att konfigurera sina databaskontexter efter miljö finns i ASP.NET Core-körningsmiljöer.

Om du får ett genereringsfel kontrollerar du att Target Framework Moniker (TFM) matchar NuGet-paketversionen i projektfilen. Följande projektfil innehåller till exempel version 3.1 för .NET Core och de nuget-paket som visas:

<Project Sdk="Microsoft.NET.Sdk.Web">

  <PropertyGroup>
    <TargetFramework>netcoreapp3.1</TargetFramework>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.AspNetCore.Diagnostics.EntityFrameworkCore" Version="3.1.0" />
    <PackageReference Include="Microsoft.AspNetCore.Identity.EntityFrameworkCore" Version="3.1.0" />
    <PackageReference Include="Microsoft.AspNetCore.Identity.UI" Version="3.1.0" />
    <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="3.1.0" />
    <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="3.1.0" />
    <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="3.1.0" />
    <PackageReference Include="Microsoft.VisualStudio.Web.CodeGeneration.Design" Version="3.1.0" />
  </ItemGroup>

</Project>

Lägga till en databaskontextklass

• I projektet RazorPagesMovie skapar du en ny mapp med namnet Data.

• Lägg till följande RazorPagesMovieContext-klass i mappen Data:

  using Microsoft.EntityFrameworkCore;
  
  namespace RazorPagesMovie.Data
  {
      public class RazorPagesMovieContext : DbContext
      {
          public RazorPagesMovieContext (
              DbContextOptions<RazorPagesMovieContext> options)
              : base(options)
          {
          }
  
          public DbSet<RazorPagesMovie.Models.Movie> Movie { get; set; }
      }
  }
  

Föregående kod skapar en DbSet-egenskap för entitetsuppsättningen. I Entity Framework-terminologi motsvarar en entitetsuppsättning vanligtvis en databastabell och en entitet motsvarar en rad i tabellen. Koden kompileras inte förrän beroenden läggs till i ett senare steg.

Lägga till en databasanslutningssträng

Lägg till en anslutningssträng i appsettings.json-filen enligt följande markerade kod:

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

Registrera databaskontexten

Lägg till följande using-instruktioner högst upp i Startup.cs:

using RazorPagesMovie.Data;
using Microsoft.EntityFrameworkCore;

Registrera databaskontexten med beroendeinjektion i -behållaren i Startup.ConfigureServices.

public void ConfigureServices(IServiceCollection services)
{
    services.AddRazorPages();

    services.AddDbContext<RazorPagesMovieContext>(options =>
        options.UseSqlite(Configuration.GetConnectionString("RazorPagesMovieContext")));
}

• I fönstret lösningsverktygkontroll-klickar du på RazorPagesMovie-projektet och väljer sedan Lägg till>ny mapp.... Ge mappen namnet Models.

• Högerklicka på mappen Models och välj sedan Lägg till>ny fil....

• I dialogrutan Ny fil:

  • Välj Allmänt i den vänstra rutan.
  • Välj Tom klass i mittenfönstret.
  • Ge klassen namnet Movie och välj Ny.

Lägg till följande egenskaper i klassen Movie:

using System;
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.

• [DataType(DataType.Date)]: Attributet DataType specificerar typen av data (Date). Med det här attributet:

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

Skapa en -mapp för sidor och filmer:

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

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

I dialogrutan Lägg till väljer du Razor sidor med Entity Framework (CRUD)>Lägg till.

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

• I listrutan Modellklass väljer du Film (RazorPagesMovie.Models).
• I raden för datakontextklassen klickar du på tecknet + (plus) och ändrar det genererade namnet från RazorPagesMovie.Models.RazorPagesMovieContext till RazorPagesMovie.Data.RazorPagesMovieContext. Den här ändringen krävs inte. Den skapar databaskontextklassen med rätt namnområde.
• Välj Lägg till.

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

• Öppna ett kommandofönster i projektkatalogen som innehåller filerna Program.cs, Startup.csoch .csproj.

• För Windows: Kör följande kommando:

  dotnet aspnet-codegenerator razorpage -m Movie -dc RazorPagesMovieContext -udl -outDir Pages\Movies --referenceScriptLibraries
  

• För macOS och Linux: Kör följande kommando:

  dotnet aspnet-codegenerator razorpage -m Movie -dc RazorPagesMovieContext -udl -outDir Pages/Movies --referenceScriptLibraries
  

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

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 matar in IWebHostEnvironment i Start. IWebHostEnvironment matas in så att ConfigureServices kan använda SQLite i utveckling och SQL Server i produktion.

public class Startup
{
    public Startup(IConfiguration configuration, IWebHostEnvironment env)
    {
        Environment = env;
        Configuration = configuration;
    }

    public IConfiguration Configuration { get; }
    public IWebHostEnvironment Environment { get; }

    public void ConfigureServices(IServiceCollection services)
    {
        if (Environment.IsDevelopment())
        {
            services.AddDbContext<RazorPagesMovieContext>(options =>
            options.UseSqlite(
                Configuration.GetConnectionString("RazorPagesMovieContext")));
        }
        else
        {
            services.AddDbContext<RazorPagesMovieContext>(options =>
            options.UseSqlServer(
                Configuration.GetConnectionString("MovieContext")));
        }

        services.AddRazorPages();
    }

    public void Configure(IApplicationBuilder app)
    {
        if (Environment.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
            app.UseDatabaseErrorPage();
        }
        else
        {
            app.UseExceptionHandler("/Error");
            app.UseHsts();
        }

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

        app.UseRouting();

        app.UseEndpoints(endpoints =>
        {
            endpoints.MapRazorPages();
        });
    }
}

Skapa en -mapp för sidor och filmer:

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

Högerklicka på mappen Pages/Movies>Add>New Scaffolding....

I dialogrutan New Scaffolding väljer du Razor Pages using Entity Framework (CRUD)>Next.

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

• I listrutan Modellklass väljer du eller skriver Film (RazorPagesMovie.Models).
• I datakontextklassen rad skriver du namnet på den nya klassen RazorPagesMovie.Data. RazorPagesMovieContext. Den här ändringen krävs inte. Den skapar databaskontextklassen med rätt namnområde.
• Välj Lägg till.

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

Lägga till EF-verktyg

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

dotnet tool install --global dotnet-ef

Föregående kommando lägger till Entity Framework Core Tools för .NET CLI. Mer information finns i referens för Entity Framework Core-verktyg – .NET CLI.

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 matar in IWebHostEnvironment i Start. IWebHostEnvironment matas in så att ConfigureServices kan använda SQLite i utveckling och SQL Server i produktion.

public class Startup
{
    public Startup(IConfiguration configuration, IWebHostEnvironment env)
    {
        Environment = env;
        Configuration = configuration;
    }

    public IConfiguration Configuration { get; }
    public IWebHostEnvironment Environment { get; }

    public void ConfigureServices(IServiceCollection services)
    {
        if (Environment.IsDevelopment())
        {
            services.AddDbContext<RazorPagesMovieContext>(options =>
            options.UseSqlite(
                Configuration.GetConnectionString("RazorPagesMovieContext")));
        }
        else
        {
            services.AddDbContext<RazorPagesMovieContext>(options =>
            options.UseSqlServer(
                Configuration.GetConnectionString("MovieContext")));
        }

        services.AddRazorPages();
    }

    public void Configure(IApplicationBuilder app)
    {
        if (Environment.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
            app.UseDatabaseErrorPage();
        }
        else
        {
            app.UseExceptionHandler("/Error");
            app.UseHsts();
        }

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

        app.UseRouting();

        app.UseEndpoints(endpoints =>
        {
            endpoints.MapRazorPages();
        });
    }
}

Scaffold-processen skapar och uppdaterar följande filer:

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

Updated

• Startup.cs

De skapade och uppdaterade filerna beskrivs i nästa avsnitt.

Scaffold-processen skapar och uppdaterar följande filer:

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

Updated

• Startup.cs

De skapade och uppdaterade filerna beskrivs i nästa avsnitt.

Scaffold-processen skapar följande filer:

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

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

I det här avsnittet används 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 kommandon:

Add-Migration InitialCreate
Update-Database

Om dotnet ef inte har installerats installerar du det som ett globalt verktyg:

  dotnet tool install --global dotnet-ef

Mer information om CLI för EF Corefinns i verktygsreferensen för .NET CLI EF Core.

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

dotnet ef migrations add InitialCreate
dotnet ef database update

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.

Granska metoden Startup.ConfigureServices. Den markerade linjen har lagts till av ställningsbyggaren:

public void ConfigureServices(IServiceCollection services)
{
    services.AddRazorPages();

    services.AddDbContext<RazorPagesMovieContext>(options =>
      options.UseSqlServer(Configuration.GetConnectionString("RazorPagesMovieContext")));
}

RazorPagesMovieContext samordnar EF Core funktioner, till exempel Skapa, Läsa, Uppdatera och Ta bort, för Movie modellen. Datakontexten (RazorPagesMovieContext) härleds från Microsoft.EntityFrameworkCore.DbContext. Datakontexten anger vilka entiteter som ingår i datamodellen.

using Microsoft.EntityFrameworkCore;

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

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

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.

Granska metoden Up.