Razor ページのチュートリアル シリーズのパート 4。

作者: Joe Audette

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

Visual Studio

using Microsoft.EntityFrameworkCore;
var builder = WebApplication.CreateBuilder(args);
var connectionString = builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.");

builder.Services.AddDbContext<RazorPagesMovieContext>(options => options.UseSqlServer(connectionString));

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

Visual Studio Code

using Microsoft.EntityFrameworkCore;
var builder = WebApplication.CreateBuilder(args);
var connectionString = builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.");

builder.Services.AddDbContext<RazorPagesMovieContext>(options => options.UseSqlite(connectionString));

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

var app = builder.Build();

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

Visual Studio

生成される接続文字列は、次の JSON のようになります。

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "AllowedHosts": "*",
  "ConnectionStrings": {
    "RazorPagesMovieContext": "Server=(localdb)\\mssqllocaldb;Database=RazorPagesMovieContext-f2e0482c-952d-4b1c-afe9-a1a3dfe52e55;Trusted_Connection=True;MultipleActiveResultSets=true"
  }
}

Visual Studio Code

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

Warning

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

Visual Studio

SQL Server Express ローカルDB

LocalDB は、プログラム開発用に設計された SQL Server Express データベース エンジンの軽量バージョンです。 LocalDB は必要に応じて起動し、ユーザー モードで実行されるので、複雑な設定は不要です。 既定では、LocalDB は*.mdf ディレクトリC:\Users\<user>\データベース ファイルを作成します。

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

   

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

   

   

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

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

   

Visual Studio Code

SQLite

SQLite の Web サイトには次のように記載されています。

SQLite は、自己完結型で信頼性の高い、埋め込まれたフル機能のパブリック ドメイン SQL Database エンジンです。 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 ステートメント

データベースをシードする

次のコードを使用して、Models フォルダーに SeedData という名前の新しいクラスを作成します。

using Microsoft.EntityFrameworkCore;

namespace RazorPagesMovie.Models;

public static class SeedData
{
    public static void Initialize(IServiceProvider serviceProvider)
    {
        using (var context = new RazorPagesMovieContext(
            serviceProvider.GetRequiredService<
                DbContextOptions<RazorPagesMovieContext>>()))
        {
            if (context == null || context.Movie == null)
            {
                throw new ArgumentNullException("Null RazorPagesMovieContext");
            }

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

シード初期化子の追加

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

Visual Studio

using Microsoft.EntityFrameworkCore;
using RazorPagesMovie.Models;
var builder = WebApplication.CreateBuilder(args);
var connectionString = builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.");

builder.Services.AddDbContext<RazorPagesMovieContext>(options => options.UseSqlServer(connectionString));

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

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

app.Run();

Visual Studio Code

using Microsoft.EntityFrameworkCore;
using RazorPagesMovie.Models;
var builder = WebApplication.CreateBuilder(args);
var connectionString = builder.Configuration.GetConnectionString("RazorPagesMovieContext") ?? throw new InvalidOperationException("Connection string 'RazorPagesMovieContext' not found.");

builder.Services.AddDbContext<RazorPagesMovieContext>(options => options.UseSqlite(connectionString));

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

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

app.Run();

前のコードでは、次の手順を実行するように Program.cs を変更します。

• app.Services.CreateScope()を使用してサービス スコープを作成します。
• スコープからサービス プロバイダー (IServiceProvider) を取得します。
• サービス プロバイダーを渡して、 SeedData.Initialize メソッドを呼び出します。
• シード メソッドが完了した時点で、サービス スコープを破棄します。 using ステートメントにより、スコープが確実に破棄されます。

Update-Databaseを実行しないと、次の例外が発生します。

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

アプリをテストする

シード メソッドが実行されるように、データベース内のすべてのレコードを削除します。 アプリを停止および起動して、データベースをシードします。 データベースがシード処理されない場合は、if (context.Movie.Any()) にブレークポイントを設定し、コードをステップ実行します。

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

次のステップ

以前: Scaffold された Razor ページ次: ページを更新