第 5 部分，在 ASP.NET Core MVC 應用程式中使用資料庫

作者：Rick Anderson 與 Jon P Smith。

簡介

本教學系列的這一部分著重於在 ASP.NET Core MVC 應用程式中使用 SQL 資料庫。

您將了解如何：

• 註冊並設定 Entity Framework Core 資料庫上下文，用於您的 ASP.NET Core MVC 應用程式。
• 在本地開發時使用資料庫連線字串。
• 使用 SQL Server Express LocalDB 進行開發，並使用 SQL Server 物件總管檢視你的資料庫與資料。
• 先用初始樣本資料為資料庫做種子。

先決條件

這個教學使用你在前一步建立的資料庫： 第四部分，將模型加入 ASP.NET Core MVC 應用程式。

處理資料庫上下文

MvcMovieContext 物件會處理連線到資料庫和將 Movie 物件對應至資料庫記錄的工作。 資料庫內容會向 檔案中的Program.cs容器註冊：

Visual Studio

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddDbContext<MvcMovieContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("MvcMovieContext") ?? throw new InvalidOperationException("Connection string 'MvcMovieContext' not found.")));

ASP.NET Core 組態系統會讀取 ConnectionString 索引鍵。 對於本機開發，程式會從 appsettings.json 檔案中取得連接字串以供使用：

"ConnectionStrings": {
  "MvcMovieContext": "Server=(localdb)\\mssqllocaldb;Database=MvcMovieContext-4ebefa10-de29-4dea-b2ad-8a8dc6bcf374;Trusted_Connection=True;MultipleActiveResultSets=true"
}

Visual Studio 程式碼

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 資料表 > [檢視資料]

Visual Studio 程式碼

SQLite

SQLite 網站指出：

SQLite 是獨立、高可靠性、內嵌式、全功能、公用領域的 SQL 資料庫引擎。 SQLite 是世界上最常使用的資料庫引擎。

您可以下載許多協力廠商工具來管理和檢視 SQLite 資料庫。 下圖是來自 SQLite 的資料庫瀏覽器。 如果您有喜歡的 SQLite 工具，請留言分享您喜歡的原因。

注意

在本教學課程中，請盡可能使用 Entity Framework Core「移轉」功能。 移轉可更新資料庫結構描述，以符合資料模型中的變更。 不過，移轉只能進行 EF Core 提供者支援的變更類型，SQLite 提供者的功能則有限制。 例如，其支援新增資料行，但不支援移除或變更資料行。 如果您建立遷移來移除或變更欄位，ef migrations add 命令會成功，但 ef database update 命令會失敗。 由於這些限制，本教學課程不會使用遷移來變更 SQLite 架構。 當模式變更時，刪除並重新建立資料庫。

SQLite 限制的因應措施是手動撰寫移轉程式碼，以在資料表有所變更時執行資料表重建。 重建資料表的過程包括：

• 建立新的資料表。
• 將資料從舊的資料表複製到新的資料表。
• 刪除舊的資料表。
• 重新命名新資料表。

如需詳細資訊，請參閱以下資源：

• SQLite EF Core 資料庫提供者限制
• 自訂移轉程式碼
• 資料植入
• SQLite ALTER TABLE 陳述式

初始化資料庫

在 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") ?? throw new InvalidOperationException("Connection string 'MvcMovieContext' not found.")));

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

app.UseAuthorization();

app.MapStaticAssets();

app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");

app.Run();

刪除資料庫中的所有記錄。 您可以使用瀏覽器或 SSOX 的刪除連結來執行這項操作。

測試應用程式。 強制應用程式初始化，呼叫 Program.cs 檔案中的程式碼，讓種子方法執行。 若要強制初始化，請關閉 Visual Studio 開啟的命令提示字元視窗，然後按 Ctrl+F5 重新啟動。

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

app.UseAuthorization();

app.MapStaticAssets();

app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");

app.Run();

刪除資料庫中的所有記錄。

測試應用程式。 停止並重新啟動它，以讓 SeedData.Initialize 方法執行並植入資料庫。

應用程式會顯示植入的資料。

上一步：新增模型下一步：新增控制器方法和檢視