第五部分，在 ASP.NET Core MVC 應用程式中操作資料庫

簡介

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

您將了解如何：

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

先決條件

這個教學使用了你在前一步設置的資料庫：Part 4，將模型加入 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 Configuration系統讀取ConnectionString金鑰。 對於本地開發，連接字串來自 appsettings.json 檔案：

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

Visual Studio Code

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

ASP.NET Core Configuration 系統讀取 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 檔案。

檢查資料庫

從 View 選單中，開啟 SQL Server 物件總管 （SSOX）。

以滑鼠右鍵按一下 Movie 資料表 (dbo.Movie) > 檢視設計師

請注意 ID 旁的索引鍵圖示。 根據預設，EF 會將名為 ID 的屬性設為主索引鍵。

以滑鼠右鍵按一下 Movie 資料表 > [檢視資料]

Visual Studio Code

SQLite

SQLite 網站指出：

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

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

注意

在這個教學中，盡可能使用 Entity Framework Core migrations 功能。 移轉可更新資料庫結構描述，以符合資料模型中的變更。 不過，移轉只能進行 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?}")
    .WithStaticAssets();

app.Run();

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

Visual Studio Code

使用下列醒目的程式碼更新 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?}")
    .WithStaticAssets();

app.Run();

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

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

重新整理 Movie 表格時，資料依然相同。

注意

您可能無法在小數欄位中輸入小數逗號。 若要在使用逗號 (",") 作為小數點的非英文地區設定及非美式英文日期格式中支援 jQuery 驗證，您必須採取將應用程式全球化的步驟。 請參考這則GitHub留言 4076 以獲得如何加入小數點逗號的說明。

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