パート 5、ASP.NET Core MVC アプリでのデータベースの操作

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

MvcMovieContext オブジェクトは、データベースへの接続と、データベース レコードへの Movie オブジェクトのマッピングのタスクを処理します。 データベース コンテキストは、Program.cs ファイルにある依存関係の挿入コンテナーに登録されます。

Visual Studio

var builder = WebApplication.CreateBuilder(args);

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

ASP.NET Core の構成システムでは ConnectionString キーが読み取られます。 ローカルで開発する場合は、 appsettings.json ファイルから接続文字列が取得されます。

"ConnectionStrings": {
  "MvcMovieContext": "Data Source=MvcMovieContext-ea7a4069-f366-4742-bd1c-3f753a804ce1.db"
}

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 の構成システムは ConnectionString を読み取ります。 ローカルで開発する場合は、 appsettings.json ファイルから接続文字列が取得されます。

"ConnectionStrings": {
  "MvcMovieContext": "Data Source=MvcMovie.db"
}

警告

この記事では、ユーザーの認証を必要としないローカル データベースを使用します。 運用アプリでは、使用可能な最も安全な認証フローを使用する必要があります。 デプロイされたテスト アプリと運用アプリの認証の詳細については、「セキュリティで保護された認証フロー」をご覧ください。

Visual Studio

SQL Server Express LocalDB

LocalDB:

• SQL Server Express データベース エンジンの軽量バージョンであり、Visual Studio とともに既定でインストールされます。
• 接続文字列を使用して、要求時に開始されます。
• プログラム開発を対象としています。 ユーザー モードで実行されるため、複雑な構成はありません。
• 既定では、C:/Users/{user} ディレクトリに .mdf ファイルが作成されます。

データベースを確認する

[表示] メニューの [SQL Server オブジェクト エクスプローラー] (SSOX) を開きます。

Movie テーブル (dbo.Movie) を右クリックして、[デザイナーの表示] を選択します。

ID の横のキー アイコンに注意してください。 既定では、EF は ID という名前のプロパティを主キーにします。

Movie テーブルを右クリックし、Movie を選択します。

Visual Studio Code / Visual Studio for Mac

SQLite

SQLite の Web サイトは次のようなものです。

SQLite は埋め込みの全機能を備えた、自己完結型かつ高信頼性でパブリック ドメインの SQL データベース エンジンです。 SQLite は、世界で最も使用されているデータベース エンジンです。

SQLite データベースを管理および表示するためにダウンロードできるサードパーティ製ツールは多数あります。 以下の画像は DB Browser for SQLite のものです。 お気に入りの SQLite ツールがございましたら、そのツールの気に入っている点についてコメントしてください。

Note

このチュートリアルでは、可能な場合は Entity Framework Core の "移行" 機能を使います。 移行では、データ モデルの変更に合わせてデータベース スキーマが更新されます。 ただし、移行では EF Core プロバイダーでサポートされている種類の変更しか行うことができず、SQLite プロバイダーの機能は制限されています。 たとえば、列の追加はサポートされていますが、列の削除や変更はサポートされていません。 列を削除または変更するために移行を作成した場合、ef migrations add コマンドは成功しますが、ef database update コマンドは失敗します。 これらの制限により、このチュートリアルでは SQLite のスキーマの変更に対しては移行を使用しません。 代わりに、スキーマを変更するときは、データベースを削除して再作成します。

SQLite の制限に対する回避策としては、テーブル内の何かが変更されたときにテーブルの再構築を実行する移行コードを、手動で作成します。 テーブルの再構築には次の作業が含まれます。

• 新しいテーブルの作成。
• 古いテーブルから新しいテーブルへのデータのコピー。
• 古いテーブルの削除。
• 新しいテーブルの名前変更。

詳細については、次のリソースを参照してください。

• SQLite EF Core データベース プロバイダーの制限事項
• 移行コードをカスタマイズする
• データのシード処理
• SQLite ALTER TABLE ステートメント

データベースのシード

SeedData フォルダーに SeedData という名前の新しいクラスを作成します。 生成されたコードを次のコードに置き換えます。

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using MvcMovie.Data;
using System;
using System.Linq;

namespace MvcMovie.Models;

public static class SeedData
{
    public static void Initialize(IServiceProvider serviceProvider)
    {
        using (var context = new MvcMovieContext(
            serviceProvider.GetRequiredService<
                DbContextOptions<MvcMovieContext>>()))
        {
            // Look for any movies.
            if (context.Movie.Any())
            {
                return;   // DB has been seeded
            }
            context.Movie.AddRange(
                new Movie
                {
                    Title = "When Harry Met Sally",
                    ReleaseDate = DateTime.Parse("1989-2-12"),
                    Genre = "Romantic Comedy",
                    Price = 7.99M
                },
                new Movie
                {
                    Title = "Ghostbusters ",
                    ReleaseDate = DateTime.Parse("1984-3-13"),
                    Genre = "Comedy",
                    Price = 8.99M
                },
                new Movie
                {
                    Title = "Ghostbusters 2",
                    ReleaseDate = DateTime.Parse("1986-2-23"),
                    Genre = "Comedy",
                    Price = 9.99M
                },
                new Movie
                {
                    Title = "Rio Bravo",
                    ReleaseDate = DateTime.Parse("1959-4-15"),
                    Genre = "Western",
                    Price = 3.99M
                }
            );
            context.SaveChanges();
        }
    }
}

データベースにムービーがある場合、シード初期化子が返され、ムービーは追加されません。

if (context.Movie.Any())
{
    return;  // DB has been seeded.
}

シード初期化子の追加

Visual Studio

Program.cs の内容を以下のコードに置き換えます。 新しいコードが強調表示されます。

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using MvcMovie.Data;
using MvcMovie.Models;

var builder = WebApplication.CreateBuilder(args);

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

// Add services to the container.
builder.Services.AddControllersWithViews();

var app = builder.Build();

using (var scope = app.Services.CreateScope())
{
    var services = scope.ServiceProvider;

    SeedData.Initialize(services);
}

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Home/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.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");

app.Run();

データベース内のすべてのレコードを削除します。 これはブラウザーの削除リンクで行うか、SSOX から行うことができます。

アプリをテストします。 アプリに初期化を強制し、Program.cs ファイルのコードを呼び出して、シード メソッドが実行されるようにします。 初期化を強制するには、Visual Studio が開いているコマンド プロンプト ウィンドウを閉じ、Ctrl + F5 キーを押して再起動します。

Visual Studio Code / Visual Studio for Mac

次の強調表示されているコードを使用して、Program.cs を更新します。

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using MvcMovie.Data;
using MvcMovie.Models;

var builder = WebApplication.CreateBuilder(args);

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

// Add services to the container.
builder.Services.AddControllersWithViews();

var app = builder.Build();

using (var scope = app.Services.CreateScope())
{
    var services = scope.ServiceProvider;

    SeedData.Initialize(services);
}

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Home/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.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");

app.Run();

データベース内のすべてのレコードを削除します。

アプリをテストします。 アプリを停止して再起動すると、SeedData.Initialize メソッドが実行され、データベースがシードされます。

アプリにシードされたデータが表示されます。

前: モデルの追加次: コントローラー メソッドとビューの追加