パート 4、ASP.NET Core MVC アプリにモデルを追加する

作成者: Rick Anderson および Jon P Smith。

このチュートリアルでは、データベースの映画を管理するためのクラスが追加されます。 これらのクラスは、MVC アプリの "モデル" 部分です。

これらのモデル クラスは、データベースを操作するために Entity Framework Core (EF Core) で使用されます。 EF Core は、記述する必要があるデータ アクセス コードを簡略化するオブジェクト リレーショナル マッピング (ORM) フレームワークです。

作成されたモデル クラスは、Plain Old CLR Objects の頭文字を取って、POCO クラスと呼ばれます。 POCO クラスには EF Core に対する依存関係はありません。 これらは、データベースに格納されるデータのプロパティのみを定義します。

このチュートリアルでは、まずモデル クラスが作成され、EF Core によってデータベースが作成されます。

データ モデル クラスの追加

Visual Studio

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

Visual Studio Code

Movie.cs という名前のファイルを Models フォルダーに追加します。

Visual Studio for Mac

Ctrl キーを押しながら Models フォルダーをクリックし、[追加]>[新しいクラス]>[空のクラス] を選びます。 そのファイルに Movie.cs という名前を付けます。

Models/Movie.cs ファイルを次のコードで更新します。

using System.ComponentModel.DataAnnotations;

namespace MvcMovie.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 の DataType 属性により、データの型 (Date) が指定されます。 この属性を使用する場合:

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

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

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

NuGet パッケージを追加する

Visual Studio

Visual Studio では、必要なパッケージが自動的にインストールされます。

コンパイラ エラーのチェックとしてプロジェクトをビルドします。

Visual Studio Code

次の .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 で複数の環境を使用する」を参照してください。

メモ

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

Visual Studio Code で、Ctrl+F5 (Windows) または ⌘+F5 (macOS) を押して、デバッグなしでアプリを実行します。

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

Visual Studio for Mac

• [プロジェクト] メニューから、 [NuGet パッケージの管理] を選択します。
• [参照] タブを選択します。
• [プレリリースを含める] を選択します。
• 右上の [検索] フィールドで、次のようにします。
  • 「Microsoft.EntityFrameworkCore.SQLite」と入力します。
  • Return キーを押して検索します。
  • 一致する NuGet パッケージを選択し、 [パッケージの追加] ボタンを選択します。

[プロジェクトの選択] ダイアログが、MvcMovie プロジェクトが選択された状態で表示されます。 [OK] ボタンを選択します。

[ライセンスの同意] ダイアログが表示されます。 ライセンスを確認し、 [同意する] ボタンを選択します。

上記の手順を繰り返して、次の NuGet パッケージをインストールします。

• Microsoft.VisualStudio.Web.CodeGeneration.Design
• Microsoft.EntityFrameworkCore.SqlServer
• Microsoft.EntityFrameworkCore.Design
• Microsoft.EntityFrameworkCore.Tools

上のパッケージには、次のものが含まれます。

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

次の .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

メモ

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

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

• EF Core のコマンドライン インターフェイス (CLI) ツール
• aspnet-codegenerator スキャフォールディング ツール。

コンパイラ エラーのチェックとしてプロジェクトをビルドします。

ムービー ページのスキャフォールディング

スキャフォールディング ツールを使用し、ムービー モデルの Create、Read、Update、Delete の (CRUD) のページを生成します。

Visual Studio

ソリューション エクスプローラーで、Controllers フォルダーを右クリックし、[追加] > [新規スキャフォールディング アイテム] の順に選択します。

[新しいスキャフォールディング アイテムの追加] ダイアログで次のようにします。

• 左側のペインで、[インストール済み]>[共通]>[MVC] を選びます。
• [Entity Framework を使用したビューがある MVC コントローラー] を選択します。
• [追加] を選択します。

[Entity Framework を使用したビューがある MVC コントローラーを追加する] ダイアログを完了します。

• [モデル クラス] ドロップ ダウンで、 [Movie (MvcMovie.Models)] を選択します。
• [データ コンテキスト クラス] 行で、[+] (プラス) 記号を選択します。
  • [データ コンテキストの追加] ダイアログで、クラス名 MvcMovie.Data.MvcMovieContext が生成されます。
  • [追加] を選択します。
• [データベース プロバイダー] ドロップダウンで、[SQL Server] を選びます。
• ビュー と コントローラー名: 既定値のままにします。
• [追加] を選択します。

エラー メッセージが表示された場合は、もう一度 [追加] を選択して再試行します。

スキャフォールディングにより、次のパッケージが追加されます。

• Microsoft.EntityFrameworkCore.SqlServer
• Microsoft.EntityFrameworkCore.Tools
• Microsoft.VisualStudio.Web.CodeGeneration.Design

スキャフォールディングによって次が作成されます。

• ムービー コントローラー: Controllers/MoviesController.cs
• 作成、削除、詳細、編集、およびインデックス ページ用の Razor ビュー ファイル: Views/Movies/*.cshtml
• データベース コンテキスト クラス: Data/MvcMovieContext.cs

スキャフォールディングによって次が更新されます。

• 必要なパッケージ参照を MvcMovie.csproj プロジェクト ファイルに挿入します。
• Program.cs ファイルでデータベース コンテキストを登録します。
• データベース接続文字列を appsettings.json ファイルに追加します。

これらのファイルとファイル更新の自動作成は、"スキャフォールディング" と呼ばれます。

データベースが存在しないため、スキャフォールディング ページをまだ使用できません。 アプリを実行し、 [Movie App] リンクを選択すると、 [データベースを開けません] または [そのようなテーブルはありません: Movie] エラー メッセージが表示されます。

アプリをビルドして、エラーがないことを確認します。

Visual Studio Code

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

macOS と Linux 上では、スキャフォールディング ツールのパスをエクスポートします。

export PATH=$HOME/.dotnet/tools:$PATH

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

dotnet aspnet-codegenerator controller -name MoviesController -m Movie -dc MvcMovie.Data.MvcMovieContext --relativeFolderPath Controllers --useDefaultLayout --referenceScriptLibraries --databaseProvider sqlite

次の表で、ASP.NET Core コード ジェネレーターのパラメーターについて詳しく説明します。

パラメーター	説明
-M	モデルの名前。
-dc	データ コンテキスト。
--relativeFolderPath	ファイルを作成するための相対出力フォルダー パス。
--useDefaultLayout|-udl	ビューには既定のレイアウトを使用してください。
--referenceScriptLibraries	[編集] および [作成] ページに _ValidationScriptsPartial を追加します。
--databaseProvider sqlite	DbContext では、SQL Server ではなく SQLite を使う必要があることを指定します。

次のように、h スイッチを使用して、aspnet-codegenerator controller コマンドに関するヘルプを取得します。

dotnet aspnet-codegenerator controller -h

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

スキャフォールディングによって次が作成されます。

• ムービー コントローラー: Controllers/MoviesController.cs
• 作成、削除、詳細、編集、およびインデックス ページ用の Razor ビュー ファイル: Views/Movies/*.cshtml
• データベース コンテキスト クラス: Data/MvcMovieContext.cs

スキャフォールディングによって次が更新されます。

• Program.cs ファイルでデータベース コンテキストを登録します。
• データベース接続文字列を appsettings.json ファイルに追加します。

これらのファイルとファイル更新の自動作成は、"スキャフォールディング" と呼ばれます。

データベースが存在しないため、スキャフォールディング ページをまだ使用できません。 アプリを実行し、 [Movie App] リンクを選択すると、 [データベースを開けません] または [そのようなテーブルはありません: Movie] エラー メッセージが表示されます。

アプリをビルドして、エラーがないことを確認します。

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

Program.cs 内の次の強調表示されたコードは、開発環境で SQLite を使用し、運用環境で SQL Server を使用する方法を示しています。

var builder = WebApplication.CreateBuilder(args);

if (builder.Environment.IsDevelopment())
{
    builder.Services.AddDbContext<MvcMovieContext>(options =>
        options.UseSqlite(builder.Configuration.GetConnectionString("MvcMovieContext")));
}
else
{
    builder.Services.AddDbContext<MvcMovieContext>(options =>
        options.UseSqlServer(builder.Configuration.GetConnectionString("ProductionMvcMovieContext")));
}

Visual Studio for Mac

プロジェクト ディレクトリでコマンド ウィンドウを開きます。 プロジェクト ディレクトリは、.csproj ファイルを含むディレクトリです。

スキャフォールディング ツールのパスをエクスポートします。

export PATH=$HOME/.dotnet/tools:$PATH

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

dotnet aspnet-codegenerator controller -name MoviesController -m Movie -dc MvcMovie.Data.MvcMovieContext --relativeFolderPath Controllers --useDefaultLayout --referenceScriptLibraries -sqlite

次の表で、ASP.NET Core コード ジェネレーターのパラメーターについて詳しく説明します。

パラメーター	説明
-M	モデルの名前。
-dc	データ コンテキスト。
--relativeFolderPath	ファイルを作成するための相対出力フォルダー パス。
--useDefaultLayout|-udl	ビューには既定のレイアウトを使用してください。
--referenceScriptLibraries	[編集] および [作成] ページに _ValidationScriptsPartial を追加します。
-sqlite	DbContext が SQL Server では SQLite を使用するかどうかを指定するフラグ。

次のように、h スイッチを使用して、aspnet-codegenerator controller コマンドに関するヘルプを取得します。

dotnet aspnet-codegenerator controller -h

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

スキャフォールディングによって次が作成されます。

• ムービー コントローラー: Controllers/MoviesController.cs
• 作成、削除、詳細、編集、およびインデックス ページ用の Razor ビュー ファイル: Views/Movies/*.cshtml
• データベース コンテキスト クラス: Data/MvcMovieContext.cs

スキャフォールディングによって次が更新されます。

• Program.cs ファイルでデータベース コンテキストを登録します。
• データベース接続文字列を appsettings.json ファイルに追加します。

これらのファイルとファイル更新の自動作成は、"スキャフォールディング" と呼ばれます。

データベースが存在しないため、スキャフォールディング ページをまだ使用できません。 アプリを実行し、 [Movie App] リンクを選択すると、 [データベースを開けません] または [そのようなテーブルはありません: Movie] エラー メッセージが表示されます。

アプリをビルドして、エラーがないことを確認します。

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

Program.cs 内の次の強調表示されたコードは、開発環境で SQLite を使用し、運用環境で SQL Server を使用する方法を示しています。

var builder = WebApplication.CreateBuilder(args);

if (builder.Environment.IsDevelopment())
{
    builder.Services.AddDbContext<MvcMovieContext>(options =>
        options.UseSqlite(builder.Configuration.GetConnectionString("MvcMovieContext")));
}
else
{
    builder.Services.AddDbContext<MvcMovieContext>(options =>
        options.UseSqlServer(builder.Configuration.GetConnectionString("ProductionMvcMovieContext")));
}

最初の移行

EF Core移行機能を使用し、データベースを作成します。 "移行" は、データ モデルに合わせてデータベースを作成および更新する一連のツールです。

Visual Studio

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

パッケージ マネージャー コンソール (PMC) で、次のコマンドを入力します。

Add-Migration InitialCreate
Update-Database

• Add-Migration InitialCreate:Migrations/{timestamp}_InitialCreate.cs 移行ファイルが生成されます。 InitialCreate 引数は、移行の名前です。 任意の名前を使用できますが、慣例により、移行を説明する名前が選択されます。 これは最初の移行であるため、生成されたクラスには、データベース スキーマを作成するコードが含まれています。 データベース スキーマは、MvcMovieContext クラスで指定されたモデルに基づきます。

• Update-Database:前のコマンドで作成された最新の移行にデータベースを更新します。 このコマンドにより Migrations/{time-stamp}_InitialCreate.cs ファイルで Up メソッドが実行され、データベースが作成されます。

Update-Database コマンドでは、以下の警告が生成されます。

エンティティ型 "Movie" の decimal プロパティ "Price" に、ストアの種類が指定されていませんでした。 これにより、値が既定の有効桁数と小数点以下桁数に収まらない場合、自動的に切り捨てられます。 "HasColumnType" を使用して "OnModelCreating" 内のすべての値を格納できる SQL Server の列型を明示的に指定するか、"HasPrecision" を使用して有効桁数と小数点以下桁数を指定するか、"HasConversion" を使用して値コンバーターを構成します。

前の警告は無視してください。これは、後のチュートリアルで修正されます。

EF Core 用の PMC ツールの詳細については、EF Core ツール リファレンスの Visual Studio の PMC に関するページを参照してください。

Visual Studio Code / Visual Studio for Mac

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

dotnet ef migrations add InitialCreate

dotnet ef database update

• ef migrations add InitialCreate:Migrations/{timestamp}_InitialCreate.cs 移行ファイルが生成されます。 InitialCreate 引数は、移行の名前です。 任意の名前を使用できますが、慣例により、移行を説明する名前が選択されます。 これは最初の移行であるため、生成されたクラスには、データベース スキーマを作成するコードが含まれています。 データベース スキーマは、Data/MvcMovieContext.cs ファイル内の MvcMovieContext クラスで指定されたモデルに基づきます。
• ef database update:前のコマンドで作成された最新の移行にデータベースを更新します。 このコマンドにより Migrations/{time-stamp}_InitialCreate.cs ファイルで Up メソッドが実行され、データベースが作成されます。

Microsoft SQL Server と SQLite のような複数のプロバイダーの保持について詳しくは、「複数のプロバイダーを使用した移行」をご覧ください。

アプリのテスト

Visual Studio

アプリを実行し、 [Movie App] リンクを選択します。

次のような例外が表示された場合は、移行手順で Update-Database コマンドを実行しなかった可能性があります。

SqlException: Cannot open database "MvcMovieContext-1" requested by the login. The login failed.

Visual Studio Code / Visual Studio for Mac

アプリを実行し、 [Movie App] リンクを選択します。

次のような例外が表示された場合は、移行手順で dotnet ef database update コマンドを実行しなかった可能性があります。

SqliteException: SQLite Error 1: 'no such table: Movie'.

Note

Price フィールドに小数点のコンマを入力できない場合があります。 小数点にコンマ (",") を使う英語以外のロケール、および英語 (米国) 以外の日付形式で、jQuery 検証をサポートするには、アプリをグローバル化する必要があります。 グローバル化の手順については、この GitHub の記事をご覧ください。

生成されたデータベース コンテキスト クラスと登録を調べる

EF Core では、データ アクセスはモデルを利用して実行されます。 モデルはエンティティ クラスと、データベースとのセッションを表すコンテキスト オブジェクトから構成されます。 このコンテキスト オブジェクトにより、データのクエリと保存が可能になります。 データベース コンテキストは Microsoft.EntityFrameworkCore.DbContext から派生し、データ モデルに含めるエンティティを指定します。

スキャフォールディングにより、Data/MvcMovieContext.cs データベース コンテキスト クラスが作成されます。

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.EntityFrameworkCore;
using MvcMovie.Models;

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

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

上記のコードによって、データベース内のムービーを表す DbSet<Movie> プロパティが作成されます。

依存関係の挿入

ASP.NET Core には、依存関係挿入 (DI) が組み込まれています。 データベース コンテキストなどのサービスは、Program.cs の DI に登録されます。 これらのサービスは、それを必要とするコンポーネントにコンストラクター パラメーターを介して提供されます。

Controllers/MoviesController.cs ファイルでは、コンストラクターが依存性の注入を使って MvcMovieContext データベース コンテキストがコントローラーに挿入されています。 データベース コンテキストは、コントローラーの各 CRUD メソッドで使用されます。

スキャフォールディングによって、Program.cs で次の強調表示されたコードが生成されました。

Visual Studio

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddDbContext<MvcMovieContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("MvcMovieContext")));

Visual Studio Code / Visual Studio for Mac

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddDbContext<MvcMovieContext>(options =>
    options.UseSqlite(builder.Configuration.GetConnectionString("MvcMovieContext")));

ASP.NET Core 構成システムによって "MvcMovieContext" データベース接続文字列が読み取られます。

生成されたデータベース接続文字列を調べる

スキャフォールディングによって、接続文字列が appsettings.json ファイルに追加されました。

Visual Studio

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "AllowedHosts": "*",
  "ConnectionStrings": {
    "MvcMovieContext": "Data Source=MvcMovieContext-ea7a4069-f366-4742-bd1c-3f753a804ce1.db"
  }
}

Visual Studio Code / Visual Studio for Mac

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

ローカル開発の場合、ASP.NET Core 構成システムによって appsettings.json ファイルから ConnectionString キーが読み取られます。

InitialCreate クラス

Migrations/{timestamp}_InitialCreate.cs 移行ファイルを調べます。

using System;
using Microsoft.EntityFrameworkCore.Migrations;

#nullable disable

namespace MvcMovie.Migrations
{
    public partial class InitialCreate : Migration
    {
        protected override void Up(MigrationBuilder migrationBuilder)
        {
            migrationBuilder.CreateTable(
                name: "Movie",
                columns: table => new
                {
                    Id = table.Column<int>(type: "int", nullable: false)
                        .Annotation("SqlServer:Identity", "1, 1"),
                    Title = table.Column<string>(type: "nvarchar(max)", nullable: true),
                    ReleaseDate = table.Column<DateTime>(type: "datetime2", nullable: false),
                    Genre = table.Column<string>(type: "nvarchar(max)", nullable: true),
                    Price = table.Column<decimal>(type: "decimal(18,2)", nullable: false)
                },
                constraints: table =>
                {
                    table.PrimaryKey("PK_Movie", x => x.Id);
                });
        }

        protected override void Down(MigrationBuilder migrationBuilder)
        {
            migrationBuilder.DropTable(
                name: "Movie");
        }
    }
}

上のコードでは以下の操作が行われます。

• InitialCreate.Up により Movie テーブルが作成され、主キーとして Id が構成されます。
• InitialCreate.Down により、Up 移行で行われたスキーマ変更が元に戻ります。

コントローラーの依存関係挿入

Controllers/MoviesController.cs ファイルを開いて、コンストラクターを調べます。

public class MoviesController : Controller
{
    private readonly MvcMovieContext _context;

    public MoviesController(MvcMovieContext context)
    {
        _context = context;
    }

コンストラクターでは、依存性の注入を使ってデータベース コンテキスト (MvcMovieContext) がコントローラーに挿入されています。 データベース コンテキストは、コントローラーの各 CRUD メソッドで使用されます。

Create ページをテストします。 データを入力して送信します。

[編集] 、 [詳細] 、 [削除] の各ページをテストします。

厳密に型指定されたモデルと @model ディレクティブ

コントローラーで ViewData ディクショナリを使ってビューにデータまたはオブジェクトを渡す方法を前に示しました。 ViewData ディクショナリは動的オブジェクトであり、ビューに情報を渡すための便利な遅延バインディングの方法を提供します。

MVC には、厳密に型指定されたモデル オブジェクトをビューに渡す機能があります。 この厳密に型指定された方法では、コンパイル時にコードを確認できます。 スキャフォールディング メカニズムでは、 MoviesController クラスとビューで、型指定されたモデルを渡しました。

Controllers/MoviesController.cs ファイルで生成された Details メソッドを確認します。

// GET: Movies/Details/5
public async Task<IActionResult> Details(int? id)
{
    if (id == null)
    {
        return NotFound();
    }

    var movie = await _context.Movie
        .FirstOrDefaultAsync(m => m.Id == id);
    if (movie == null)
    {
        return NotFound();
    }

    return View(movie);
}

通常、id パラメーターはルート データとして渡されます。 たとえば、https://localhost:5001/movies/details/1 は次のように設定します。

• コントローラーを movies コントローラーに (最初の URL セグメント)。
• アクションを details に (2 番目の URL セグメント)。
• id を 1 に (最後の URL セグメント)。

id は、次の例で示すようにクエリ文字列で渡すことができます。

https://localhost:5001/movies/details?id=1

id 値が指定されていない場合、id パラメーターは null 許容型 (int?) として定義されます。

ルート データまたはクエリ文字列の値と一致するムービー エンティティを選択するため、ラムダ式が FirstOrDefaultAsync メソッドに渡されます。

var movie = await _context.Movie
    .FirstOrDefaultAsync(m => m.Id == id);

ムービーが見つかった場合、Movie モデルのインスタンスが Details ビューに渡されます。

return View(movie);

Views/Movies/Details.cshtml ファイルの内容を確認します。

@model MvcMovie.Models.Movie

@{
    ViewData["Title"] = "Details";
}

<h1>Details</h1>

<div>
    <h4>Movie</h4>
    <hr />
    <dl class="row">
        <dt class = "col-sm-2">
            @Html.DisplayNameFor(model => model.Title)
        </dt>
        <dd class = "col-sm-10">
            @Html.DisplayFor(model => model.Title)
        </dd>
        <dt class = "col-sm-2">
            @Html.DisplayNameFor(model => model.ReleaseDate)
        </dt>
        <dd class = "col-sm-10">
            @Html.DisplayFor(model => model.ReleaseDate)
        </dd>
        <dt class = "col-sm-2">
            @Html.DisplayNameFor(model => model.Genre)
        </dt>
        <dd class = "col-sm-10">
            @Html.DisplayFor(model => model.Genre)
        </dd>
        <dt class = "col-sm-2">
            @Html.DisplayNameFor(model => model.Price)
        </dt>
        <dd class = "col-sm-10">
            @Html.DisplayFor(model => model.Price)
        </dd>
    </dl>
</div>
<div>
    <a asp-action="Edit" asp-route-id="@Model.Id">Edit</a> |
    <a asp-action="Index">Back to List</a>
</div>

ビュー ファイルの一番上にある @model ステートメントにより、ビューで求められるオブジェクトの型が指定されます。 ムービー コントローラーが作成されたとき、次の @model ステートメントが含まれました。

@model MvcMovie.Models.Movie

この @model ディレクティブにより、コントローラーでビューに渡されたムービーにアクセスできます。 Model オブジェクトは厳密に型指定されます。 たとえば、Details.cshtml ビューでは、コードで厳密に型指定された Model オブジェクトを使って、DisplayNameFor と DisplayFor の HTML ヘルパーに各ムービー フィールドを渡しています。 Create および Edit のメソッドとビューも、Movie モデル オブジェクトを渡します。

Movies コントローラーの Index.cshtml ビューと Index メソッドを確認します。 コードで View メソッドを呼び出すときの List オブジェクトの作成方法に注意してください。 コードでは、この Movies リストを Index アクション メソッドからビューに渡しています。

// GET: Movies
public async Task<IActionResult> Index()
{
    return View(await _context.Movie.ToListAsync());
}

データ コンテキストの Movie プロパティが null の場合、このコードは問題の詳細を返します。

ムービー コントローラーが作成されたとき、スキャフォールディングにより、Index.cshtml ファイルの一番上に次の @model ステートメントが含まれました。

@model IEnumerable<MvcMovie.Models.Movie>

@model ディレクティブにより、厳密に型指定された Model オブジェクトを使って、コントローラーがビューに渡したムービーのリストにアクセスできます。 たとえば、Index.cshtmlIndex.cshtmlforeach ビューのコードでは、foreach ステートメントを使って厳密に型指定された Model オブジェクトのムービーをループ処理しています。

@model IEnumerable<MvcMovie.Models.Movie>

@{
    ViewData["Title"] = "Index";
}

<h1>Index</h1>

<p>
    <a asp-action="Create">Create New</a>
</p>
<table class="table">
    <thead>
        <tr>
            <th>
                @Html.DisplayNameFor(model => model.Title)
            </th>
            <th>
                @Html.DisplayNameFor(model => model.ReleaseDate)
            </th>
            <th>
                @Html.DisplayNameFor(model => model.Genre)
            </th>
            <th>
                @Html.DisplayNameFor(model => model.Price)
            </th>
            <th></th>
        </tr>
    </thead>
    <tbody>
@foreach (var item in Model) {
        <tr>
            <td>
                @Html.DisplayFor(modelItem => item.Title)
            </td>
            <td>
                @Html.DisplayFor(modelItem => item.ReleaseDate)
            </td>
            <td>
                @Html.DisplayFor(modelItem => item.Genre)
            </td>
            <td>
                @Html.DisplayFor(modelItem => item.Price)
            </td>
            <td>
                <a asp-action="Edit" asp-route-id="@item.Id">Edit</a> |
                <a asp-action="Details" asp-route-id="@item.Id">Details</a> |
                <a asp-action="Delete" asp-route-id="@item.Id">Delete</a>
            </td>
        </tr>
}
    </tbody>
</table>

Model オブジェクトは IEnumerable<Movie> オブジェクトとして厳密に型指定されているので、ループ内の各項目は Movie として型指定されます。 それ以外の利点として、コンパイラはコードで使用されている型を検証します。

その他の技術情報

• 初心者向け Entity Framework Core
• タグ ヘルパー
• グローバライズとローカライズ

前: ビューの追加次: SQL の使用