パート 2: ASP.NET Core で Razor ページ アプリにモデルを追加する

1. ソリューション エクスプローラーで、RazorPagesMovie プロジェクトを右クリックし、>[追加]>[新しいフォルダー] の順に選択します。 フォルダーに「 Modelsで行うことができます。

2. Models フォルダーを右クリックしします。 [追加]>[クラス] の順に選択します。 クラスに Movie と名前を付けます。

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

Movie クラスには次が含まれます。

• ID フィールドは、データベースで主キー用に必要です。

• プロパティのデータの型を指定する ReleaseDate 属性。 この属性を使用する場合:

  • ユーザーは日付フィールドに時刻の情報を入力する必要はありません。
  • 日付のみが表示され、時刻の情報は表示されません。

• string の後の疑問符は、そのプロパティが Null 許容であることを示します。 詳細については、「null 許容参照型」を参照してください。

DataAnnotations は、後のチュートリアルで説明されます。

プロジェクトをビルドして、コンパイル エラーがないことを確認します。

1. Models という名前のフォルダーを追加します。
2. Models という名前の Movie.cs フォルダーにクラスを追加します。

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

Movie クラスには次が含まれます。

• データベースの主キーを提供する ID フィールド。

• フィールドのデータの型を指定するための ReleaseDate 属性。 この属性を使用する場合:

  • ユーザーは日付フィールドに時刻の情報を入力する必要はありません。
  • 日付のみが表示され、時刻の情報は表示されません。

• string の後の疑問符は、そのプロパティが Null 許容であることを示します。 詳細については、「null 許容参照型」を参照してください。

DataAnnotations は、後のチュートリアルで説明されます。

NuGet パッケージと EF ツールを追加します。

次の .NET CLI コマンドを実行します。

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

上記のコマンドにより次が追加されます。

• EF Core のコマンドライン インターフェイス (CLI) ツール
• aspnet-codegenerator スキャフォールディング ツール。
• EF Core 用のデザイン時ツール
• EF Core SQLite プロバイダー。これにより、EF Core パッケージが依存関係としてインストールされます。
• スキャフォールディングに必要なパッケージ: Microsoft.VisualStudio.Web.CodeGeneration.Design と Microsoft.EntityFrameworkCore.SqlServer。

アプリが環境ごとにデータベース コンテキストを構成できるようにする複数環境構成に関するガイダンスについては、「ASP.NET Core で複数の環境を使用する」を参照してください。

Visual Studio Code Ctrl+F5 を押して、デバッグなしでアプリを実行します。

エディター領域の下にある [パネル] で [問題] タブを選択するか、[表示] メニューから [問題] を選択します (現在表示されていない場合)。 コンパイル エラーがないことを確認します。

1. Pages/Movies フォルダーを作成します。

   1. Pages フォルダーを右クリックし、>> の順に選択します。
   2. フォルダーに Movies という名前を付けます。

2. Pages/Movies フォルダーを右クリックし、>> の順に選択します。

   

3. [新しいスキャフォールディングの追加] ダイアログで、[Entity Framework を使用する Razor Pages (CRUD)]>[追加] の順に選択します。

   

4. [Add Razor Pages using Entity Framework (CRUD)](Entity Framework を使用して Razor Pages (CRUD) を追加する) ダイアログを完了します。

   1. [モデル クラス] ドロップ ダウンで、[Movie (RazorPagesMovie.Models)] を選択します。
   2. Data context class 行で、 + (+) 記号を選択します。
      1. [データ コンテキストの追加] ダイアログで、クラス名 RazorPagesMovie.Data.RazorPagesMovieContext が生成されます。
      2. [データベース プロバイダー] ドロップダウンで、[SQL Server] を選びます。
   3. Select Add.

   

appsettings.json ファイルは、ローカル データベースへの接続に使用される接続文字列を使用して更新されます。

• ファイル Program.cs と .csproj が格納されているプロジェクト ディレクトリでコマンド シェルを開きます。 次のコマンドを実行します。

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

次の表で、ASP.NET Core コード ジェネレーターのオプションについて詳しく説明します。

-h コマンドに関するヘルプを取得するには、dotnet aspnet-codegenerator razorpage オプションを使用します。

dotnet aspnet-codegenerator razorpage -h

詳細については、「dotnet aspnet-codegenerator」を参照してください。

開発用に SQLite を、運用環境に SQL Server を使用する

SQLite が選択されている場合、テンプレートで生成されたコードは開発の準備ができています。 次のコードは、開発時には SQLite の接続文字列を選択し、運用時には SQL Server を選択する方法を示したものです。

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

開発モードでは UseDeveloperExceptionPage によって WebApplication が呼び出されるので、上のコードでは開発時には UseDeveloperExceptionPage は呼び出されません。

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

このセクションでは、パッケージ マネージャー コンソール (PMC) ウィンドウを使用して、次の作業を行います。

• 初期移行を追加します。

• 初期移行でデータベースを更新します。

• [ツール] メニューで、[NuGet パッケージ マネージャー]>[パッケージ マネージャー コンソール] の順に選択します。

  

• PMC で、次のコマンドを入力します。

  Add-Migration InitialCreate
  

• Add-Migration コマンドによって最初のデータベース スキーマを作成するコードが生成されます。 このスキーマは、DbContext で指定されたモデルに基づきます。 InitialCreate 引数は、移行の名前を指定するために使用されます。 任意の名前を使用できますが、規則により、移行を説明する名前が選択されます。

次の警告が表示されますが、これは後の手順で対処します。

エンティティ型 'Movie' の decimal 列 'Price' に型が指定されていません。 これにより、値が既定の有効桁数と小数点以下桁数に収まらない場合、自動的に切り捨てられます。 'HasColumnType()' を使用してすべての値に適合する SQL server 列の型を明示的に指定します。

• PMC で、次のコマンドを入力します。

  Update-Database
  

  Update-Database コマンドにより、適用されていない移行で Up メソッドが実行されます。 ここでは、コマンドにより、Up ファイルの Migrations/<time-stamp>_InitialCreate.cs メソッドが実行され、データベースが作成されます。

• RazorPagesMovie.csproj プロジェクトを右クリックし、[Open in Integrated Terminal] (統合ターミナルで開く) を選択します。

  [ターミナル] ウィンドウが開き、Program.cs および .csproj ファイルを含むプロジェクト ディレクトリにコマンド プロンプトが表示されます。

• 次の .NET CLI コマンドを実行します。

  dotnet ef migrations add InitialCreate
  

  migrations コマンドによって最初のデータベース スキーマを作成するコードが生成されます。 このスキーマは、DbContext で指定されたモデルに基づきます。 InitialCreate 引数は移行の命名に使用されます。 任意の名前を使用できますが、規則により、移行を説明する名前が選択されます。

• 次の .NET CLI コマンドを実行します。

  dotnet ef database update
  

  update コマンドにより、適用されていない移行で Up メソッドが実行されます。 ここでは、update により、Up ファイルの Migrations/<time-stamp>_InitialCreate.cs メソッドが実行され、データベースが作成されます。

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. ソリューション エクスプローラーで、RazorPagesMovie プロジェクトを右クリックし、>[追加]>[新しいフォルダー] の順に選択します。 フォルダーに「 Modelsで行うことができます。

2. Models フォルダーを右クリックしします。 [追加]>[クラス] の順に選択します。 クラスに Movie と名前を付けます。

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

Movie クラスには次が含まれます。

• ID フィールドは、データベースで主キー用に必要です。

• プロパティのデータの型を指定する ReleaseDate 属性。 この属性を使用する場合:

  • ユーザーは日付フィールドに時刻の情報を入力する必要はありません。
  • 日付のみが表示され、時刻の情報は表示されません。

• string の後の疑問符は、そのプロパティが Null 許容であることを示します。 詳細については、「null 許容参照型」を参照してください。

DataAnnotations は、後のチュートリアルで説明されます。

プロジェクトをビルドして、コンパイル エラーがないことを確認します。

1. Models という名前のフォルダーを追加します。
2. Models という名前の Movie.cs フォルダーにクラスを追加します。

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

Movie クラスには次が含まれます。

• データベースの主キーを提供する ID フィールド。

• フィールドのデータの型を指定するための ReleaseDate 属性。 この属性を使用する場合:

  • ユーザーは日付フィールドに時刻の情報を入力する必要はありません。
  • 日付のみが表示され、時刻の情報は表示されません。

• string の後の疑問符は、そのプロパティが Null 許容であることを示します。 詳細については、「null 許容参照型」を参照してください。

DataAnnotations は、後のチュートリアルで説明されます。

NuGet パッケージと EF ツールを追加します。

次の .NET CLI コマンドを実行します。

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

上記のコマンドにより次が追加されます。

• EF Core のコマンドライン インターフェイス (CLI) ツール
• aspnet-codegenerator スキャフォールディング ツール。
• EF Core 用のデザイン時ツール
• EF Core SQLite プロバイダー。これにより、EF Core パッケージが依存関係としてインストールされます。
• スキャフォールディングに必要なパッケージ: Microsoft.VisualStudio.Web.CodeGeneration.Design と Microsoft.EntityFrameworkCore.SqlServer。

アプリが環境ごとにデータベース コンテキストを構成できるようにする複数環境構成に関するガイダンスについては、「ASP.NET Core で複数の環境を使用する」を参照してください。

Visual Studio Code Ctrl+F5 を押して、デバッグなしでアプリを実行します。

エディター領域の下にある [パネル] で [問題] タブを選択するか、[表示] メニューから [問題] を選択します (現在表示されていない場合)。 コンパイル エラーがないことを確認します。

1. Pages/Movies フォルダーを作成します。

   1. Pages フォルダーを右クリックし、>> の順に選択します。
   2. フォルダーに Movies という名前を付けます。

2. Pages/Movies フォルダーを右クリックし、>> の順に選択します。

   

3. [新しいスキャフォールディングの追加] ダイアログで、[Entity Framework を使用する Razor Pages (CRUD)]>[追加] の順に選択します。

   

4. [Add Razor Pages using Entity Framework (CRUD)](Entity Framework を使用して Razor Pages (CRUD) を追加する) ダイアログを完了します。

   1. [モデル クラス] ドロップ ダウンで、[Movie (RazorPagesMovie.Models)] を選択します。
   2. Data context class 行で、 + (+) 記号を選択します。
      1. [データ コンテキストの追加] ダイアログで、クラス名 RazorPagesMovie.Data.RazorPagesMovieContext が生成されます。
      2. [データベース プロバイダー] ドロップダウンで、[SQL Server] を選びます。
   3. Select Add.

   

appsettings.json ファイルは、ローカル データベースへの接続に使用される接続文字列を使用して更新されます。

• ファイル Program.cs と .csproj が格納されているプロジェクト ディレクトリでコマンド シェルを開きます。 次のコマンドを実行します。

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

次の表で、ASP.NET Core コード ジェネレーターのオプションについて詳しく説明します。

-h コマンドに関するヘルプを取得するには、dotnet aspnet-codegenerator razorpage オプションを使用します。

dotnet aspnet-codegenerator razorpage -h

詳細については、「dotnet aspnet-codegenerator」を参照してください。

開発用に SQLite を、運用環境に SQL Server を使用する

SQLite が選択されている場合、テンプレートで生成されたコードは開発の準備ができています。 次のコードは、開発時には SQLite の接続文字列を選択し、運用時には SQL Server を選択する方法を示したものです。

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

開発モードでは UseDeveloperExceptionPage によって WebApplication が呼び出されるので、上のコードでは開発時には UseDeveloperExceptionPage は呼び出されません。

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

このセクションでは、パッケージ マネージャー コンソール (PMC) ウィンドウを使用して、次の作業を行います。

• 初期移行を追加します。

• 初期移行でデータベースを更新します。

• [ツール] メニューで、[NuGet パッケージ マネージャー]>[パッケージ マネージャー コンソール] の順に選択します。

  

• PMC で、次のコマンドを入力します。

  Add-Migration InitialCreate
  

• Add-Migration コマンドによって最初のデータベース スキーマを作成するコードが生成されます。 このスキーマは、DbContext で指定されたモデルに基づきます。 InitialCreate 引数は、移行の名前を指定するために使用されます。 任意の名前を使用できますが、規則により、移行を説明する名前が選択されます。

次の警告が表示されますが、これは後の手順で対処します。

エンティティ型 'Movie' の decimal 列 'Price' に型が指定されていません。 これにより、値が既定の有効桁数と小数点以下桁数に収まらない場合、自動的に切り捨てられます。 'HasColumnType()' を使用してすべての値に適合する SQL server 列の型を明示的に指定します。

• PMC で、次のコマンドを入力します。

  Update-Database
  

  Update-Database コマンドにより、適用されていない移行で Up メソッドが実行されます。 ここでは、コマンドにより、Up ファイルの Migrations/<time-stamp>_InitialCreate.cs メソッドが実行され、データベースが作成されます。

• RazorPagesMovie.csproj プロジェクトを右クリックし、[Open in Integrated Terminal] (統合ターミナルで開く) を選択します。

  [ターミナル] ウィンドウが開き、Program.cs および .csproj ファイルを含むプロジェクト ディレクトリにコマンド プロンプトが表示されます。

• 次の .NET CLI コマンドを実行します。

  dotnet ef migrations add InitialCreate
  

  migrations コマンドによって最初のデータベース スキーマを作成するコードが生成されます。 このスキーマは、DbContext で指定されたモデルに基づきます。 InitialCreate 引数は移行の命名に使用されます。 任意の名前を使用できますが、規則により、移行を説明する名前が選択されます。

• 次の .NET CLI コマンドを実行します。

  dotnet ef database update
  

update コマンドにより、適用されていない移行で Up メソッドが実行されます。 ここでは、update により、Up ファイルの Migrations/<time-stamp>_InitialCreate.cs メソッドが実行され、データベースが作成されます。

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. ソリューション エクスプローラーで、RazorPagesMovie プロジェクトを右クリックし、>[追加]>[新しいフォルダー] の順に選択します。 フォルダーに「 Modelsで行うことができます。

2. Models フォルダーを右クリックしします。 [追加]>[クラス] の順に選択します。 クラスに Movie と名前を付けます。

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

Movie クラスには次が含まれます。

• ID フィールドは、データベースで主キー用に必要です。

• プロパティのデータの型を指定する ReleaseDate 属性。 この属性を使用する場合:

  • ユーザーは日付フィールドに時刻の情報を入力する必要はありません。
  • 日付のみが表示され、時刻の情報は表示されません。

• string の後の疑問符は、そのプロパティが Null 許容であることを示します。 詳細については、「null 許容参照型」を参照してください。

DataAnnotations は、後のチュートリアルで説明されます。

プロジェクトをビルドして、コンパイル エラーがないことを確認します。

1. Models という名前のフォルダーを追加します。
2. Models という名前の Movie.cs フォルダーにクラスを追加します。

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

Movie クラスには次が含まれます。

• データベースの主キーを提供する ID フィールド。

• フィールドのデータの型を指定するための ReleaseDate 属性。 この属性を使用する場合:

  • ユーザーは日付フィールドに時刻の情報を入力する必要はありません。
  • 日付のみが表示され、時刻の情報は表示されません。

• string の後の疑問符は、そのプロパティが Null 許容であることを示します。 詳細については、「null 許容参照型」を参照してください。

DataAnnotations は、後のチュートリアルで説明されます。

NuGet パッケージと EF ツールを追加します。

次の .NET CLI コマンドを実行します。

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

上記のコマンドにより次が追加されます。

• EF Core のコマンドライン インターフェイス (CLI) ツール
• aspnet-codegenerator スキャフォールディング ツール。
• EF Core 用のデザイン時ツール
• EF Core SQLite プロバイダー。これにより、EF Core パッケージが依存関係としてインストールされます。
• スキャフォールディングに必要なパッケージ: Microsoft.VisualStudio.Web.CodeGeneration.Design と Microsoft.EntityFrameworkCore.SqlServer。

アプリが環境ごとにデータベース コンテキストを構成できるようにする複数環境構成に関するガイダンスについては、「ASP.NET Core で複数の環境を使用する」を参照してください。

Visual Studio Code Ctrl+F5 を押して、デバッグなしでアプリを実行します。

エディター領域の下にある [パネル] で [問題] タブを選択するか、[表示] メニューから [問題] を選択します (現在表示されていない場合)。 コンパイル エラーがないことを確認します。

1. ソリューション ツール ウィンドウで、Control キーを押しながら RazorPagesMovie プロジェクトをクリックし、[追加]>[新しいフォルダー...] の順に選択します。フォルダーに Models という名前を付けます。

2. Control キーを押しながら Models フォルダーをクリックし、[追加]>[新しいクラス] を選択します。

3. [新しいファイル] ダイアログで次を実行します。

   1. 左側のウィンドウで [全般] を選択します。
   2. 中央ウィンドウで [空のクラス] を選択します。
   3. クラスに Movie という名前を付け、 [作成] を選択します。

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

Movie クラスには次が含まれます。

• データベースの主キーを提供する ID フィールド。

• フィールドのデータの型を指定するための ReleaseDate 属性。 この属性を使用する場合:

  • ユーザーは日付フィールドに時刻の情報を入力する必要はありません。
  • 日付のみが表示され、時刻の情報は表示されません。

DataAnnotations は、後のチュートリアルで説明されます。

プロジェクトをビルドして、コンパイル エラーがないことを確認します。

1. Pages/Movies フォルダーを作成します。

   1. Pages フォルダーを右クリックし、>> の順に選択します。
   2. フォルダーに Movies という名前を付けます。

2. Pages/Movies フォルダーを右クリックし、>> の順に選択します。

   

3. [新しいスキャフォールディングの追加] ダイアログで、[Entity Framework を使用する Razor Pages (CRUD)]>[追加] の順に選択します。

   

4. [Add Razor Pages using Entity Framework (CRUD)](Entity Framework を使用して Razor Pages (CRUD) を追加する) ダイアログを完了します。

   1. [モデル クラス] ドロップ ダウンで、[Movie (RazorPagesMovie.Models)] を選択します。
   2. Data context class 行で、 + (+) 記号を選択します。
      1. [データ コンテキストの追加] ダイアログで、クラス名 RazorPagesMovie.Data.RazorPagesMovieContext が生成されます。
      2. [データベース プロバイダー] ドロップダウンで、[SQL Server] を選びます。
   3. Select Add.

   

appsettings.json ファイルは、ローカル データベースへの接続に使用される接続文字列を使用して更新されます。

• ファイル Program.cs と .csproj が格納されているプロジェクト ディレクトリでコマンド シェルを開きます。 次のコマンドを実行します。

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

次の表で、ASP.NET Core コード ジェネレーターのオプションについて詳しく説明します。

-h コマンドに関するヘルプを取得するには、dotnet aspnet-codegenerator razorpage オプションを使用します。

dotnet aspnet-codegenerator razorpage -h

詳細については、「dotnet aspnet-codegenerator」を参照してください。

開発用に SQLite を、運用環境に SQL Server を使用する

SQLite が選択されている場合、テンプレートで生成されたコードは開発の準備ができています。 次のコードは、開発時には SQLite の接続文字列を選択し、運用時には SQL Server を選択する方法を示したものです。

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

開発モードでは UseDeveloperExceptionPage によって WebApplication が呼び出されるので、上のコードでは開発時には UseDeveloperExceptionPage は呼び出されません。

1. スキャフォールディング ツールに必要な NuGet パッケージ Microsoft.EntityFrameworkCore.Sqlite を追加します。

   1. ソリューション ツール ウィンドウで、Control キーを押しながら RazorPagesMovie プロジェクトをクリックし、[ターミナルで開く] を選択します。

   [ターミナル] ウィンドウが開き、Program.cs および .csproj ファイルを含むプロジェクト ディレクトリにコマンド プロンプトが表示されます。

   1. 次の .NET CLI コマンドを実行します。

     dotnet add package Microsoft.EntityFrameworkCore.SQLite
   

2. Pages/Movies フォルダーを作成します。

   1. Control キーを押しながら Pages フォルダーをクリックし、>> の順に選択します。
   2. フォルダーに Movies という名前を付けます。

3. Control キーを押しながら Pages/Movies フォルダーをクリックし、>> を選択します。

   

4. [新しいスキャフォールディング] ダイアログで、[Entity Framework を使用する Razor Pages (CRUD)]>[次へ] の順に選択します。

   

5. [Add Razor Pages using Entity Framework (CRUD)](Entity Framework を使用して Razor Pages (CRUD) を追加する) ダイアログを完了します。

   1. [使用するモデル クラス] で「Movie」と入力します。
   2. [DbContext Class to use:](使用する DbContext クラス:) 行で、クラスに RazorPagesMovie.Data.RazorPagesMovieContext という名前を付けます。
   3. Select Finish.

   

必要なパッケージが自動的にダウンロードされ、プロジェクトに追加されるため、スキャフォールディング プロセスが完了するまでに時間がかかる場合があります。

appsettings.json ファイルは、ローカル データベースへの接続に使用される接続文字列を使用して更新されます。

開発用に SQLite を、運用環境に SQL Server を使用する

SQLite が選択されている場合、テンプレートで生成されたコードは開発の準備ができています。 次のコードは、開発時には SQLite の接続文字列を選択し、運用時には SQL Server を選択する方法を示したものです。

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

開発モードでは UseDeveloperExceptionPage によって WebApplication が呼び出されるので、上のコードでは開発時には UseDeveloperExceptionPage は呼び出されません。

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

このセクションでは、パッケージ マネージャー コンソール (PMC) ウィンドウを使用して、次の作業を行います。

• 初期移行を追加します。
• 初期移行でデータベースを更新します。

1. [ツール] メニューで、[NuGet パッケージ マネージャー]>[パッケージ マネージャー コンソール] の順に選択します。

   

2. PMC で、次のコマンドを入力します。

   Add-Migration InitialCreate
   Update-Database
   

• Add-Migration コマンドによって最初のデータベース スキーマを作成するコードが生成されます。 このスキーマは、DbContext で指定されたモデルに基づきます。 InitialCreate 引数は、移行の名前を指定するために使用されます。 任意の名前を使用できますが、規則により、移行を説明する名前が選択されます。

• Update-Database コマンドにより、適用されていない移行で Up メソッドが実行されます。 ここでは、コマンドにより、Up ファイルの Migrations/<time-stamp>_InitialCreate.cs メソッドが実行され、データベースが作成されます。

• RazorPagesMovie.csproj プロジェクトを右クリックし、[Open in Integrated Terminal] (統合ターミナルで開く) を選択します。

  [ターミナル] ウィンドウが開き、Program.cs および .csproj ファイルを含むプロジェクト ディレクトリにコマンド プロンプトが表示されます。

• 次の .NET CLI コマンドを実行します。

  dotnet ef migrations add InitialCreate
  dotnet ef database update
  

• migrations コマンドによって最初のデータベース スキーマを作成するコードが生成されます。 このスキーマは、DbContext で指定されたモデルに基づきます。 InitialCreate 引数は移行の命名に使用されます。 任意の名前を使用できますが、規則により、移行を説明する名前が選択されます。

• update コマンドにより、適用されていない移行で Up メソッドが実行されます。 ここでは、update により、Up ファイルの Migrations/<time-stamp>_InitialCreate.cs メソッドが実行され、データベースが作成されます。

• Ctrl キーを押しながら [RazorPagesMovie] をクリックし、[ターミナルで開く] を選択します。

  [ターミナル] ウィンドウが開き、Program.cs および .csproj ファイルを含むプロジェクト ディレクトリにコマンド プロンプトが表示されます。

• 次の .NET CLI コマンドを実行します。

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

• tool コマンドを実行すると、以前のバージョン (存在する場合) をアンインストールした後、最新の Entity Framework Core のツールがインストールされます。

  Note

  既定では、インストールする .NET バイナリのアーキテクチャは、現在実行中の OS アーキテクチャを表します。 別の OS アーキテクチャを指定するには、「dotnet tool install, --arch option」を参照してください。 詳細については、GitHub イシュー dotnet/AspNetCore.Docs #29262 を参照してください。

• migrations コマンドによって最初のデータベース スキーマを作成するコードが生成されます。 このスキーマは、DbContext で指定されたモデルに基づきます。 InitialCreate 引数は移行の命名に使用されます。 任意の名前を使用できますが、規則により、移行を説明する名前が選択されます。

• update コマンドにより、適用されていない移行で Up メソッドが実行されます。 ここでは、update により、Up ファイルの Migrations/<time-stamp>_InitialCreate.cs メソッドが実行され、データベースが作成されます。

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. ソリューション エクスプローラーで、RazorPagesMovie プロジェクトを右クリックし、>[追加]>[新しいフォルダー] の順に選択します。 フォルダーに「 Modelsで行うことができます。

2. Models フォルダーを右クリックしします。 [追加]>[クラス] の順に選択します。 クラスに Movie と名前を付けます。

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

Movie クラスには次が含まれます。

• ID フィールドは、データベースで主キー用に必要です。

• プロパティのデータの型を指定する ReleaseDate 属性。 この属性を使用する場合:

  • ユーザーは日付フィールドに時刻の情報を入力する必要はありません。
  • 日付のみが表示され、時刻の情報は表示されません。

1. Models という名前のフォルダーを追加します。
2. Models という名前の Movie.cs フォルダーにクラスを追加します。

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

Movie クラスには次が含まれます。

• データベースの主キーを提供する ID フィールド。

• フィールドのデータの型を指定するための ReleaseDate 属性。 この属性を使用する場合:

  • ユーザーは日付フィールドに時刻の情報を入力する必要はありません。
  • 日付のみが表示され、時刻の情報は表示されません。

NuGet パッケージと EF ツールを追加します。

次の .NET CLI コマンドを実行します。

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

上記のコマンドにより次が追加されます。

• EF Core のコマンドライン インターフェイス (CLI) ツール
• aspnet-codegenerator スキャフォールディング ツール。
• EF Core 用のデザイン時ツール
• EF Core SQLite プロバイダー。これにより、EF Core パッケージが依存関係としてインストールされます。
• スキャフォールディングに必要なパッケージ: Microsoft.VisualStudio.Web.CodeGeneration.Design と Microsoft.EntityFrameworkCore.SqlServer。

アプリが環境ごとにデータベース コンテキストを構成できるようにする複数環境構成に関するガイダンスについては、「ASP.NET Core で複数の環境を使用する」を参照してください。

1. ソリューション ツール ウィンドウで、RazorPagesMovie プロジェクトを右クリックし、[追加]>[新しいフォルダー...] の順に選択します。フォルダーに Models という名前を付けます。

2. Models フォルダーを右クリックし、[追加]>[新しいファイル] の順に選択します。

3. [新しいファイル] ダイアログで次を実行します。

   1. 左側のウィンドウで [全般] を選択します。
   2. 中央ウィンドウで [空のクラス] を選択します。
   3. クラスに Movie という名前を付け、 [作成] を選択します。

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

Movie クラスには次が含まれます。

• データベースの主キーを提供する ID フィールド。

• フィールドのデータの型を指定するための ReleaseDate 属性。 この属性を使用する場合:

  • ユーザーは日付フィールドに時刻の情報を入力する必要はありません。
  • 日付のみが表示され、時刻の情報は表示されません。

1. スキャフォールディング ツールに必要な NuGet パッケージ Microsoft.EntityFrameworkCore.Design を追加します。

   1. [ツール] メニューから、[NuGet パッケージ マネージャー]>[ソリューションの NuGet パッケージの管理] を選択します。
   2. [参照] タブを選択します。
   3. 「Microsoft.EntityFrameworkCore.Design」と入力し、一覧から選択します。
   4. [プロジェクト] をオンにしてから、 [インストール] を選択します
   5. [ライセンスへの同意] ダイアログで [同意する] を選択します。

2. Pages/Movies フォルダーを作成します。

   1. Pages フォルダーを右クリックし、>> の順に選択します。
   2. フォルダーに Movies という名前を付けます。

3. Pages/Movies フォルダーを右クリックし、>> の順に選択します。

   

4. [新しいスキャフォールディングの追加] ダイアログで、[Entity Framework を使用する Razor Pages (CRUD)]>[追加] の順に選択します。

   

5. [Add Razor Pages using Entity Framework (CRUD)](Entity Framework を使用して Razor Pages (CRUD) を追加する) ダイアログを完了します。

   1. [モデル クラス] ドロップ ダウンで、[Movie (RazorPagesMovie.Models)] を選択します。
   2. Data context class 行で、 + (+) 記号を選択します。
      1. [データ コンテキストの追加] ダイアログで、クラス名 RazorPagesMovie.Data.RazorPagesMovieContext が生成されます。
   3. Select Add.

   

   Microsoft.EntityFrameworkCore.SqlServer パッケージをインストールする必要があることを示すエラー メッセージが表示された場合は、[追加]>[新規スキャフォールディング アイテム] で始まる手順を繰り返します。

appsettings.json ファイルは、ローカル データベースへの接続に使用される接続文字列を使用して更新されます。

• ファイル Program.cs と .csproj が格納されているプロジェクト ディレクトリでコマンド シェルを開きます。 次のコマンドを実行します。

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

次の表で、ASP.NET Core コード ジェネレーターのオプションについて詳しく説明します。

-h コマンドに関するヘルプを取得するには、dotnet aspnet-codegenerator razorpage オプションを使用します。

dotnet aspnet-codegenerator razorpage -h

詳細については、「dotnet aspnet-codegenerator」を参照してください。

開発用に SQLite を、運用環境に SQL Server を使用する

SQLite が選択されている場合、テンプレートで生成されたコードは開発の準備ができています。 次のコードは、開発時には SQLite の接続文字列を選択し、運用時には SQL Server を選択する方法を示したものです。

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

開発モードでは UseDeveloperExceptionPage によって WebApplication が呼び出されるので、上のコードでは開発時には UseDeveloperExceptionPage は呼び出されません。

1. Pages/Movies フォルダーを作成します。

   1. Pages フォルダーを右クリックし、>> の順に選択します。
   2. フォルダーに Movies という名前を付けます。

2. Pages/Movies フォルダーを右クリックし、>> を選択します。

   

3. [新しいスキャフォールディング] ダイアログで、[Entity Framework を使用する Razor Pages (CRUD)]>[次へ] の順に選択します。

   

4. [Add Razor Pages using Entity Framework (CRUD)](Entity Framework を使用して Razor Pages (CRUD) を追加する) ダイアログを完了します。

   1. [使用するモデル クラス] で「Movie」と入力します。
   2. [DbContext Class to use:](使用する DbContext クラス:) 行で、クラスに RazorPagesMovie.Data.RazorPagesMovieContext という名前を付けます。
   3. Select Finish.

   

appsettings.json ファイルは、ローカル データベースへの接続に使用される接続文字列を使用して更新されます。

開発用に SQLite を、運用環境に SQL Server を使用する

SQLite が選択されている場合、テンプレートで生成されたコードは開発の準備ができています。 次のコードは、開発時には SQLite の接続文字列を選択し、運用時には SQL Server を選択する方法を示したものです。

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

開発モードでは UseDeveloperExceptionPage によって WebApplication が呼び出されるので、上のコードでは開発時には UseDeveloperExceptionPage は呼び出されません。

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

このセクションでは、パッケージ マネージャー コンソール (PMC) ウィンドウを使用して、次の作業を行います。

• 初期移行を追加します。
• 初期移行でデータベースを更新します。

1. [ツール] メニューで、[NuGet パッケージ マネージャー]>[パッケージ マネージャー コンソール] の順に選択します。

   

2. PMC で、次のコマンドを入力します。

   Add-Migration InitialCreate
   Update-Database
   
   

• ソリューション ツール ウィンドウで、RazorPagesMovie プロジェクトを右クリックし、[ターミナルで開く] を選択します。

  [ターミナル] ウィンドウが開き、Program.cs および .csproj ファイルを含むプロジェクト ディレクトリにコマンド プロンプトが表示されます。

• 次の .NET CLI コマンドを実行します。

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

  Note

  既定では、インストールする .NET バイナリのアーキテクチャは、現在実行中の OS アーキテクチャを表します。 別の OS アーキテクチャを指定するには、「dotnet tool install, --arch option」を参照してください。 詳細については、GitHub イシュー 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. ソリューション エクスプローラーで、RazorPagesMovie プロジェクトを右クリックし、>[追加]>[新しいフォルダー] の順に選択します。 フォルダーに「 Modelsで行うことができます。

2. Models フォルダーを右クリックしします。 [追加]>[クラス] の順に選択します。 クラスに Movie と名前を付けます。

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

Movie クラスには次が含まれます。

• ID フィールドは、データベースで主キー用に必要です。

• [DataType(DataType.Date)]: [DataType] 属性では、データの種類 (Date) を指定します。 この属性を使用する場合:

  • ユーザーは日付フィールドに時刻の情報を入力する必要はありません。
  • 日付のみが表示され、時刻の情報は表示されません。

1. Models という名前のフォルダーを追加します。
2. Models という名前の Movie.cs フォルダーにクラスを追加します。

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

Movie クラスには次が含まれます。

• ID フィールドは、データベースで主キー用に必要です。

• [DataType(DataType.Date)]: [DataType] 属性では、データの種類 (Date) を指定します。 この属性を使用する場合:

  • ユーザーは日付フィールドに時刻の情報を入力する必要はありません。
  • 日付のみが表示され、時刻の情報は表示されません。

NuGet パッケージと EF ツールを追加します。

次の .NET CLI コマンドを実行します。

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

上記のコマンドにより次が追加されます。

• EF Core のコマンドライン インターフェイス (CLI) ツール
• aspnet-codegenerator スキャフォールディング ツール。
• EF Core 用のデザイン時ツール
• EF Core SQLite プロバイダー。これにより、EF Core パッケージが依存関係としてインストールされます。
• スキャフォールディングに必要なパッケージ: Microsoft.VisualStudio.Web.CodeGeneration.Design と Microsoft.EntityFrameworkCore.SqlServer。

アプリが環境ごとにデータベース コンテキストを構成できるようにする複数環境構成に関するガイダンスについては、「ASP.NET Core で複数の環境を使用する」を参照してください。

スキャフォールディング エラーが発生した場合は、ターゲット フレームワーク モニカー (TFM) がプロジェクト ファイル内の NuGet パッケージのバージョンと一致していることを確認します。 たとえば、次のプロジェクト ファイルでは、.NET Core のバージョン 5.0 と、一覧表示された NuGet パッケージが使用されます。

<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. ソリューション ツール ウィンドウで、Control キーを押しながら RazorPagesMovie プロジェクトをクリックし、[追加]>[新しいフォルダー...] の順に選択します。フォルダーに Models という名前を付けます。

2. Control キーを押しながら Models フォルダーをクリックし、[追加]>[新しいファイル] の順に選択します。

3. [新しいファイル] ダイアログで次を実行します。

   1. 左側のウィンドウで [全般] を選択します。
   2. 中央ウィンドウで [空のクラス] を選択します。
   3. クラスに Movie という名前を付け、 [新規] を選択します。

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

Movie クラスには次が含まれます。

• ID フィールドは、データベースで主キー用に必要です。

• [DataType(DataType.Date)]: [DataType] 属性では、データの種類 (Date) を指定します。 この属性を使用する場合:

  • ユーザーは日付フィールドに時刻の情報を入力する必要はありません。
  • 日付のみが表示され、時刻の情報は表示されません。

1. Pages/Movies フォルダーを作成します。

   1. Pages フォルダーを右クリックし、>> の順に選択します。
   2. フォルダーに Movies という名前を付けます。

2. Pages/Movies フォルダーを右クリックし、>> の順に選択します。

   

3. [スキャフォールディングを追加] ダイアログで、[Entity Framework を使用する Razor Pages (CRUD)]>[追加] の順に選択します。

   

4. [Add Razor Pages using Entity Framework (CRUD)](Entity Framework を使用して Razor Pages (CRUD) を追加する) ダイアログを完了します。

   1. [モデル クラス] ドロップ ダウンで、[Movie (RazorPagesMovie.Models)] を選択します。
   2. Data context class 行で、 + (+) 記号を選択します。
      1. [データ コンテキストの追加] ダイアログで、クラス名 RazorPagesMovie.Data.RazorPagesMovieContext が生成されます。
   3. Select Add.

   

appsettings.json ファイルは、ローカル データベースへの接続に使用される接続文字列を使用して更新されます。

• Program.cs、Startup.cs および .csproj のファイルが格納されているプロジェクト ディレクトリでコマンド シェルを開きます。 次のコマンドを実行します。

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

次の表で、ASP.NET Core コード ジェネレーターのオプションについて詳しく説明します。

-h コマンドに関するヘルプを取得するには、dotnet aspnet-codegenerator razorpage オプションを使用します。

dotnet aspnet-codegenerator razorpage -h

詳細については、「dotnet aspnet-codegenerator」を参照してください。

開発用に SQLite を、運用環境に SQL Server を使用する

SQLite が選択されている場合、テンプレートで生成されたコードは開発の準備ができています。 次のコードは、IWebHostEnvironment に Startup を挿入する方法を示しています。 IWebHostEnvironment が挿入されているので、ConfigureServices では開発用に SQLite を、運用環境に SQL Server を使用できます。

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. Pages/Movies フォルダーを作成します。

   1. Control キーを押しながら Pages フォルダーをクリックし、>> の順に選択します。
   2. フォルダーに Movies という名前を付けます。

2. Control キーを押しながら Pages/Movies フォルダーをクリックし、>> を選択します。

   

3. [新しいスキャフォールディング] ダイアログで、[Entity Framework を使用する Razor Pages (CRUD)]>[次へ] の順に選択します。

   

4. [Add Razor Pages using Entity Framework (CRUD)](Entity Framework を使用して Razor Pages (CRUD) を追加する) ダイアログを完了します。

   1. [DbContext Class to use:](使用する DbContext クラス:) 行で、クラスに RazorPagesMovie.Data.RazorPagesMovieContext という名前を付けます。
   2. Select Finish.

   

appsettings.json ファイルは、ローカル データベースへの接続に使用される接続文字列を使用して更新されます。

開発用に SQLite を、運用環境に SQL Server を使用する

SQLite が選択されている場合、テンプレートで生成されたコードは開発の準備ができています。 次のコードは、IWebHostEnvironment に Startup を挿入する方法を示しています。 IWebHostEnvironment が挿入されているので、ConfigureServices では開発用に SQLite を、運用環境に SQL Server を使用できます。

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

このセクションでは、パッケージ マネージャー コンソール (PMC) ウィンドウを使用して、次の作業を行います。

• 初期移行を追加します。
• 初期移行でデータベースを更新します。

1. [ツール] メニューで、[NuGet パッケージ マネージャー]>[パッケージ マネージャー コンソール] の順に選択します。

   

2. PMC で、次のコマンドを入力します。

   Add-Migration InitialCreate
   Update-Database
   

• 次の .NET CLI コマンドを実行します。

  dotnet ef migrations add InitialCreate
  dotnet ef database update
  

依存関係挿入に登録されるコンテキストを調べる

ASP.NET Core には、依存関係挿入が組み込まれています。 サービス (EF Core データベース コンテキストなど) は、アプリケーションの起動時に依存関係の挿入に登録されます。 これらのサービスを必要とするコンポーネント (Razor Pages など) は、コンストラクターのパラメーターを介して指定されます。 データベース コンテキスト インスタンスを取得するコンストラクター コードは、この後のチュートリアルで示します。

スキャフォールディング ツールによってデータベース コンテキストが自動的に作成され、依存関係挿入コンテナーに登録されました。

Startup.ConfigureServices メソッドを調べます。 強調表示された行は、スキャフォールダーによって追加されました。

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

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

RazorPagesMovieContext は、EF Core モデルに関する Movie の機能 (作成、読み取り、更新、削除など) を調整します。 データ コンテキスト (RazorPagesMovieContext) は Microsoft.EntityFrameworkCore.DbContext から派生されます。 データ コンテキストによって、データ モデルに含めるエンティティが指定されます。

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

上記のコードによって、エンティティ セットの DbSet<Movie> プロパティが作成されます。 Entity Framework の用語では、エンティティ セットは通常はデータベース テーブルに対応します。 エンティティはテーブル内の行に対応します。

DbContextOptions オブジェクトでメソッドが呼び出され、接続文字列の名前がコンテキストに渡されます。 ローカル開発の場合、構成システムによって、appsettings.json ファイルから接続文字列が読み取られます。

Up メソッドを調べます。

RazorPagesMovie プロジェクトを右クリックし、>[追加]>[新しいフォルダー] の順に選択します。 フォルダーに「 Modelsで行うことができます。

Models フォルダーを右クリックしします。 [追加]>[クラス] の順に選択します。 クラスに Movie と名前を付けます。

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

Movie クラスには次が含まれます。

• ID フィールドは、データベースで主キー用に必要です。

• [DataType(DataType.Date)]: DataType 属性では、データの型 (Date) を指定します。 この属性を使用する場合:

  • ユーザーは日付フィールドに時刻の情報を入力する必要はありません。
  • 日付のみが表示され、時刻の情報は表示されません。

DataAnnotations は、後のチュートリアルで説明されます。

• Models という名前のフォルダーを追加します。
• Models という名前の Movie.cs フォルダーにクラスを追加します。

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

Movie クラスには次が含まれます。

• ID フィールドは、データベースで主キー用に必要です。

• [DataType(DataType.Date)]: DataType 属性では、データの型 (Date) を指定します。 この属性を使用する場合:

  • ユーザーは日付フィールドに時刻の情報を入力する必要はありません。
  • 日付のみが表示され、時刻の情報は表示されません。

DataAnnotations は、後のチュートリアルで説明されます。

NuGet パッケージと EF ツールを追加します。

次の .NET CLI コマンドを実行します。

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

上記のコマンドにより次が追加されます。

• aspnet-codegenerator スキャフォールディング ツール。
• .NET CLI の Entity Framework Core ツール。
• EF Core SQLite プロバイダー。これにより、EF Core パッケージが依存関係としてインストールされます。
• スキャフォールディングに必要なパッケージ: Microsoft.VisualStudio.Web.CodeGeneration.Design と Microsoft.EntityFrameworkCore.SqlServer。

アプリが環境ごとにデータベース コンテキストを構成できるようにする複数環境構成に関するガイダンスについては、「ASP.NET Core で複数の環境を使用する」を参照してください。

スキャフォールディング エラーが発生した場合は、ターゲット フレームワーク モニカー (TFM) がプロジェクト ファイル内の NuGet パッケージのバージョンと一致していることを確認します。 たとえば、次のプロジェクト ファイルには、.NET Core のバージョン 3.1 と、一覧表示された NuGet パッケージが含まれています。

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

データベース コンテキスト クラスの追加

• RazorPagesMovie プロジェクト内に、Data という名前の新しいフォルダーを作成します。

• 次の RazorPagesMovieContext クラスを 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; }
      }
  }
  

上記のコードによって、エンティティ セットの DbSet プロパティが作成されます。 Entity Framework の用語では、エンティティ セットは通常はデータベース テーブルに対応し、エンティティはテーブルの行に対応します。 このコードは、後の手順で依存関係が追加されるまでコンパイルされません。

データベース接続文字列の追加

次の強調表示されたコードに示されているように、 appsettings.json ファイルに接続文字列を追加します。

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

データベース コンテキストの登録

using の先頭に次の Startup.cs ステートメントを追加します。

using RazorPagesMovie.Data;
using Microsoft.EntityFrameworkCore;

でStartup.ConfigureServicesコンテナーを使用し、データベース コンテキストを登録します。

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

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

• ソリューション ツール ウィンドウで、Control キーを押しながら RazorPagesMovie プロジェクトをクリックし、[追加]>[新しいフォルダー...] の順に選択します。フォルダーに Models という名前を付けます。

• Models フォルダーを右クリックし、[追加]>[新しいファイル] の順に選択します。

• [新しいファイル] ダイアログで次を実行します。

  • 左側のウィンドウで [全般] を選択します。
  • 中央ウィンドウで [空のクラス] を選択します。
  • クラスに Movie という名前を付け、 [新規] を選択します。

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

Movie クラスには次が含まれます。

• ID フィールドは、データベースで主キー用に必要です。

• [DataType(DataType.Date)]: DataType 属性では、データの型 (Date) を指定します。 この属性を使用する場合:

  • ユーザーは日付フィールドに時刻の情報を入力する必要はありません。
  • 日付のみが表示され、時刻の情報は表示されません。

Pages/Movies フォルダーを作成します。

• Pages フォルダーを右クリックし、>> の順に選択します。
• フォルダーに Movies という名前を付けます。

Pages/Movies フォルダーを右クリックし、>> の順に選択します。

[スキャフォールディングを追加] ダイアログで、[Entity Framework を使用する Razor Pages (CRUD)]>[追加] の順に選択します。

[Add Razor Pages using Entity Framework (CRUD)](Entity Framework を使用して Razor Pages (CRUD) を追加する) ダイアログを完了します。

• [モデル クラス] ドロップ ダウンで、[Movie (RazorPagesMovie.Models)] を選択します。
• データ コンテキスト クラス行で、+ (プラス) 記号を選択し、生成された名前 RazorPagesMovie.Models.RazorPagesMovieContext を RazorPagesMovie.Data.RazorPagesMovieContext に変更します。 この変更は必須ではありません。 これにより、正しい名前空間を使用してデータベース コンテキスト クラスが作成されます。
• Select Add.

appsettings.json ファイルは、ローカル データベースへの接続に使用される接続文字列を使用して更新されます。

• Program.cs、Startup.cs および .csproj のファイルが格納されているプロジェクト ディレクトリでコマンド ウィンドウを開きます。

• Windows の場合:次のコマンドを実行します。

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

• macOS および Linux の場合:次のコマンドを実行します。

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

次の表で、ASP.NET Core コード ジェネレーターのオプションについて詳しく説明します。

-h コマンドに関するヘルプを取得するには、dotnet aspnet-codegenerator razorpage オプションを使用します。

dotnet aspnet-codegenerator razorpage -h

詳細については、「dotnet aspnet-codegenerator」を参照してください。

開発用に SQLite を、運用環境に SQL Server を使用する

SQLite が選択されている場合、テンプレートで生成されたコードは開発の準備ができています。 次のコードでは、スタートアップに IWebHostEnvironment を挿入する方法を示します。 IWebHostEnvironment が挿入されているので、ConfigureServices では開発用に SQLite を、運用環境に SQL Server を使用できます。

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

Pages/Movies フォルダーを作成します。

• Pages フォルダーを右クリックし、>> の順に選択します。
• フォルダーに Movies という名前を付けます。

Pages/Movies フォルダーを右クリックし、>> を選択します。

[新しいスキャフォールディング] ダイアログで、[Entity Framework を使用する Razor Pages (CRUD)]>[次へ] の順に選択します。

[Add Razor Pages using Entity Framework (CRUD)](Entity Framework を使用して Razor Pages (CRUD) を追加する) ダイアログを完了します。

• [モデル クラス] ドロップ ダウンで、[Movie (RazorPagesMovie.Models)] を選択するか、または入力します。
• データ コンテキスト クラス行で、新しいクラスの名前「RazorPagesMovie.Data.RazorPagesMovieContext」を入力します。 この変更は必須ではありません。 これにより、正しい名前空間を使用してデータベース コンテキスト クラスが作成されます。
• Select Add.

appsettings.json ファイルは、ローカル データベースへの接続に使用される接続文字列を使用して更新されます。

EF ツールの追加

次の .NET CLI コマンドを実行します。

dotnet tool install --global dotnet-ef

上記のコマンドによって .NET CLI の Entity Framework Core ツールが追加されます。 詳細については、「Entity Framework Core ツール リファレンス - .NET CLI」を参照してください。

開発用に SQLite を、運用環境に SQL Server を使用する

SQLite が選択されている場合、テンプレートで生成されたコードは開発の準備ができています。 次のコードでは、スタートアップに IWebHostEnvironment を挿入する方法を示します。 IWebHostEnvironment が挿入されているので、ConfigureServices では開発用に SQLite を、運用環境に SQL Server を使用できます。

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

スキャフォールディングのプロセスが作成され、次のファイルが更新されます。

• Pages/Movies: 作成、削除、詳細、編集、インデックス。
• Data/RazorPagesMovieContext.cs

Updated

• Startup.cs

作成および更新されたファイルについては、次のセクションで説明します。

スキャフォールディングのプロセスが作成され、次のファイルが更新されます。

• Pages/Movies: 作成、削除、詳細、編集、インデックス。
• Data/RazorPagesMovieContext.cs

Updated

• Startup.cs

作成および更新されたファイルについては、次のセクションで説明します。

スキャフォールディングのプロセスでは、次のファイルが作成されます。

• Pages/Movies: 作成、削除、詳細、編集、インデックス。

作成されたファイルについては、次のセクションで説明します。

このセクションでは、パッケージ マネージャー コンソール (PMC) を使用して、次の作業を行います。

• 初期移行を追加します。
• 初期移行でデータベースを更新します。

[ツール] メニューで、[NuGet パッケージ マネージャー]>[パッケージ マネージャー コンソール] の順に選択します。

PMC で、次のコマンドを入力します。

Add-Migration InitialCreate
Update-Database

dotnet ef がインストールされていない場合は、グローバル ツールとしてインストールします。

  dotnet tool install --global dotnet-ef

EF Core 用の CLI の詳細については、.NET CLI の EF Core ツール リファレンスを参照してください。

次の .NET CLI コマンドを実行します。

dotnet ef migrations add InitialCreate
dotnet ef database update

依存関係挿入に登録されるコンテキストを調べる

ASP.NET Core には、依存関係挿入が組み込まれています。 サービス (EF Core データベース コンテキストなど) は、アプリケーションの起動時に依存関係の挿入に登録されます。 これらのサービスを必要とするコンポーネント (Razor Pages など) は、コンストラクターのパラメーターを介して指定されます。 データベース コンテキスト インスタンスを取得するコンストラクター コードは、この後のチュートリアルで示します。

スキャフォールディング ツールによってデータベース コンテキストが自動的に作成され、依存関係挿入コンテナーに登録されました。

Startup.ConfigureServices メソッドを調べます。 強調表示された行は、スキャフォールダーによって追加されました。

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

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

RazorPagesMovieContext は、EF Core モデルに関する Movie の機能 (作成、読み取り、更新、削除など) を調整します。 データ コンテキスト (RazorPagesMovieContext) は Microsoft.EntityFrameworkCore.DbContext から派生されます。 データ コンテキストによって、データ モデルに含めるエンティティが指定されます。

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

上記のコードによって、エンティティ セットの DbSet<Movie> プロパティが作成されます。 Entity Framework の用語では、エンティティ セットは通常はデータベース テーブルに対応します。 エンティティはテーブル内の行に対応します。

DbContextOptions オブジェクトでメソッドが呼び出され、接続文字列の名前がコンテキストに渡されます。 ローカル開発の場合、構成システムによって、appsettings.json ファイルから接続文字列が読み取られます。

Up メソッドを調べます。