教學課程：開始使用 ASP.NET Core 中的 Razor Pages

發行項
02/12/2024

注意

這不是這篇文章的最新版本。如需目前版本，請參閱本文的 .NET 8 版本。

重要

這些發行前產品的相關資訊在產品正式發行前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

如需目前版本，請參閱本文的 .NET 8 版本。

作者：Rick Anderson

這是系列中的第一個教學課程，教導您建置 ASP.NET Core Razor Pages Web 應用程式的基本概念。

如需適用於熟悉控制器與檢視之開發人員的進階介紹，請參閱 Razor Pages 簡介。如需影片簡介，請參閱適用於初學者的 Entity Framework Core。

如果您不熟悉 ASP.NET Core 開發，且不確定哪些 ASP.NET Core web UI 解決方案最適合您的需求，請參閱選擇 ASP.NET Core UI。

在本教學課程結束時，您將會有一個用來管理電影資料庫的 Razor Pages Web 應用程式。

Home 或索引頁面

必要條件

Visual Studio 2022 和 ASP.NET 與 Web 開發工作負載。

建立 Razor Pages Web 應用程式

啟動 Visual Studio，然後選取 [新增專案]。
在 [建立新專案] 對話方塊中，選取 [ASP.NET Core Web 應用程式 (Razor Pages)]>[下一步]。
在 [設定新專案] 對話方塊中，輸入 RazorPagesMovie 作為 [專案名稱]。請務必將專案命名為 RazorPagesMovie (大小寫需相符)，如此，在您複製並貼上範例程式碼時命名空間才會相符。
選取 [下一步] 。
在 [其他資訊] 對話方塊中：
- 選取 [.NET 8.0 (長期支援)]。
- 確認：未勾選 [不要使用最上層陳述式]。
選取建立。

下列起始專案會隨即建立：

如需建立專案的替代方法，請參閱在 Visual Studio 中建立新專案。

本教學課程假設您熟悉 VS Code。如需詳細資訊，請參閱 VS Code 使用者入門。

從 [終端機] 功能表中選取 [新增終端機]，以開啟整合式終端機。
變更為將會包含專案的目錄 (cd)。
執行下列命令：
```
dotnet new webapp -o RazorPagesMovie
code -r RazorPagesMovie
```
dotnet new 命令會在 RazorPagesMovie 資料夾中建立新的 Razor Pages 專案。

code 命令會在目前的 Visual Studio Code 執行個體中開啟 RazorPagesMovie 資料夾。

Visual Studio Code 會顯示對話方塊，詢問：您是否信任此資料夾中檔案的作者？

如果您信任父資料夾中的所有檔案，請選取 [信任父資料夾中所有檔案的作者]。
選取 [是，信任作者]，因為專案資料夾有 .NET 產生的檔案。
當 Visual Studio Code 要求您新增資產以建置和偵錯專案時，請選取 [是]。如果 Visual Studio Code 不提供新增建置和偵錯資產，請選取 [檢視]>[命令選擇區]，然後在搜尋方塊中輸入「.NET」。從命令清單中選取 .NET: Generate Assets for Build and Debug 命令。

Visual Studio Code 會新增 .vscode 資料夾，其中包含產生的 launch.json 和 tasks.json 檔案。

在 Visual Studio for Mac 2022 中，選取 [檔案]>[新增專案...]。
在 [為新專案選擇範本] 對話方塊中：
- 選取 [Web 和主控台]>[應用程式]>[Web 應用程式]。
- 選取 [繼續]。
在 [設定新的 Web 應用程式] 對話方塊中：
- 確認：目標 Framework 設定為 .NET 8.0 (或更新版本)。
- 確認：[驗證] 設定為 [無驗證]。
- 確認：未勾選 [不要使用最上層陳述式]。
- 選取 [繼續]。
在 [設定新的 Web 應用程式] 對話方塊中：
- 針對 [專案名稱] 輸入 RazorPagesMovie。請務必將專案命名為 RazorPagesMovie (大小寫需相符)，如此，在您複製並貼上範例程式碼時命名空間才會相符。
- 選取建立。

執行應用程式

在方案總管中選取 [RazorPagesMovie]，然後按 Ctrl+F5 直接執行應用程式而不使用偵錯工具。

當專案尚未設定為使用 SSL 時，Visual Studio 會顯示下列對話方塊：

此專案設定為使用 SSL。為避免瀏覽器中的 SSL 警告，您可以選擇信任 IIS Express 產生的自我簽署憑證。您要信任 IIS Express SSL 憑證嗎？

如果您信任 IIS Express SSL 憑證，請選取 [是]。

此時會顯示下列對話方塊：

安全性警告對話方塊

若您同意信任開發憑證，請選取 [是]。

如需關於信任 Firefox 瀏覽器的資訊，請參閱 Firefox SEC_ERROR_INADEQUATE_KEY_USAGE 憑證錯誤。

Visual Studio：

執行會啟動 Kestrel 伺服器的應用程式。
在 https://localhost:<port> 啟動預設瀏覽器，以顯示應用程式 UI。 <port> 是應用程式建立時指派的隨機連接埠。

關閉瀏覽器視窗。

藉由執行下列命令來信任 HTTPS 開發憑證：
```
dotnet dev-certs https --trust
```
上述命令無法在 Linux 上使用。如需信任憑證的資訊，請參閱您的 Linux 發行版本文件。

若憑證先前不受信任，則上述命令會顯示下列對話方塊：
若您同意信任開發憑證，請選取 [是]。

如需詳細資訊，請參閱信任 ASP.NET Core HTTPS 開發憑證。

如需關於信任 Firefox 瀏覽器的資訊，請參閱 Firefox SEC_ERROR_INADEQUATE_KEY_USAGE 憑證錯誤。

在 Visual Studio Code 中，按 Ctrl+F5 (Windows) 或 ⌘+F5 (macOS)，以執行應用程式而不進行偵錯。

在 [選取偵錯工具] 提示字元中，選取 [.NET 5+ 和 .NET Core]。

選取環境對話方塊

使用下列 URL 啟動的預設瀏覽器：https://localhost:<port>，其中 <port> 是隨機產生的連接埠號碼。

關閉瀏覽器視窗。

在 Visual Studio Code 的 [執行] 功能表中，選取 [停止偵錯] 或按 [Shift]+[F5] 以停止應用程式。

檢查專案檔

以下幾節概要說明您將在後續的教學課程中使用的主要專案資料夾和檔案。

Pages 資料夾

包含 Razor 頁面和支援檔案。每個 Razor 頁面都是一組檔案：

一個 .cshtml 檔案，內含 HTML 標記和使用 Razor 語法的 C# 程式碼。
有 C# 程式碼可處理頁面事件的 .cshtml.cs 檔案。

支援檔案的名稱以底線開頭。例如，_Layout.cshtml 檔案會設定所有頁面通用的 UI 元素。 _Layout.cshtml 會設定頁面頂端的導覽功能表和頁面底部的著作權聲明。如需詳細資訊，請參 ASP.NET 中的配置。

wwwroot 資料夾

包含靜態資產，例如 HTML 檔案、JavaScript 檔案和 CSS 檔案。如需詳細資訊，請參閱 ASP.NET Core 中的靜態檔案。

`appsettings.json`

包含設定資料，例如連接字串。如需詳細資訊，請參閱 ASP.NET Core 中的組態。

Program.cs

包含下列程式碼：

var builder = WebApplication.CreateBuilder(args);

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

var app = builder.Build();

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

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

此檔案中的以下幾行程式碼會建立具有預設值的 WebApplicationBuilder，將 Razor Pages 支援新增至相依性插入 (DI) 容器，並建置應用程式：

var builder = WebApplication.CreateBuilder(args);

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

var app = builder.Build();

依預設會啟用開發人員例外狀況頁面，並提供例外狀況的實用資訊。生產應用程式不應在開發模式中執行，因為開發人員例外狀況頁面可能會洩漏敏感性資訊。

當應用程式並非以開發模式執行時，下列程式碼會將例外狀況端點設定為 /Error，並啟用 HTTP 嚴格的傳輸安全性通訊協定 (HSTS)：

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

例如，上述程式碼會在應用程式處於生產或測試模式時執行。如需詳細資訊，請參閱在 ASP.NET Core 中使用多個環境 (部分機器翻譯)。

下列程式碼會啟用多種不同的中介軟體：

app.UseHttpsRedirection();：將 HTTP 要求重新導向至 HTTPS。
app.UseStaticFiles();：允許提供靜態檔案，例如 HTML、CSS、影像和 JavaScript。如需詳細資訊，請參閱 ASP.NET Core 中的靜態檔案。
app.UseRouting();：將路由比對新增至中介軟體管線。如需詳細資訊，請參閱 ASP.NET Core 中的路由
app.MapRazorPages();：設定 Razor Pages 的端點路由。
app.UseAuthorization();：授權給使用者存取安全資源。此應用程式不使用授權，因此可以移除這一行。
app.Run();：執行應用程式。

使用已完成的範例進行疑難排解

若您遇到無法解決的問題，請將您的程式碼與已完成的專案進行比較。檢視或下載已完成的專案 (如何下載)。

下一步

下一步：新增模型

這是系列中的第一個教學課程，教導您建置 ASP.NET Core Razor Pages Web 應用程式的基本概念。

如需適用於熟悉控制器與檢視之開發人員的進階介紹，請參閱 Razor Pages 簡介。如需影片簡介，請參閱適用於初學者的 Entity Framework Core。

如果您不熟悉 ASP.NET Core 開發，且不確定哪些 ASP.NET Core web UI 解決方案最適合您的需求，請參閱選擇 ASP.NET Core UI。

在本教學課程結束時，您將會有一個用來管理電影資料庫的 Razor Pages Web 應用程式。

Home 或索引頁面

必要條件

Visual Studio 2022 和 ASP.NET 與 Web 開發工作負載。

建立 Razor Pages Web 應用程式

啟動 Visual Studio 並選取 [建立新專案]。
在 [建立新專案] 對話方塊中，選取 [ASP.NET Core Web 應用程式]>[下一步]。
在 [設定新專案] 對話方塊中，輸入 RazorPagesMovie 作為 [專案名稱]。請務必將專案命名為 RazorPagesMovie (大小寫需相符)，如此，在您複製並貼上範例程式碼時命名空間才會相符。
選取 [下一步] 。
在 [其他資訊] 對話方塊中：
- 選取 [.NET 7.0 (標準期間支援)]。
- 確認：未勾選 [不要使用最上層陳述式]。
選取建立。

下列起始專案會隨即建立：

如需建立專案的替代方法，請參閱在 Visual Studio 中建立新專案。

本教學課程假設您熟悉 VS Code。如需詳細資訊，請參閱 VS Code 使用者入門。

從 [終端機] 功能表中選取 [新增終端機]，以開啟整合式終端機。
變更為將會包含專案的目錄 (cd)。
執行下列命令：
```
dotnet new webapp -o RazorPagesMovie
code -r RazorPagesMovie
```
dotnet new 命令會在 RazorPagesMovie 資料夾中建立新的 Razor Pages 專案。

code 命令會在目前的 Visual Studio Code 執行個體中開啟 RazorPagesMovie 專案資料夾。

Visual Studio Code 會顯示對話方塊，詢問：您是否信任此資料夾中檔案的作者？

如果您信任父資料夾中的所有檔案，請選取 [信任父資料夾中所有檔案的作者]。
選取 [是，信任作者]，因為專案資料夾有 .NET 產生的檔案。
當 Visual Studio Code 要求您新增資產以建置和偵錯專案時，請選取 [是]。如果 Visual Studio Code 不提供新增建置和偵錯資產，請選取 [檢視]>[命令選擇區]，然後在搜尋方塊中輸入「.NET」。從命令清單中選取 .NET: Generate Assets for Build and Debug 命令。

Visual Studio Code 會新增 .vscode 資料夾，其中包含產生的 launch.json 和 tasks.json 檔案。

在 Visual Studio for Mac 2022 中，選取 [檔案]>[新增專案...]。
在 [為新專案選擇範本] 對話方塊中：
- 選取 [Web 和主控台]>[應用程式]>[Web 應用程式]。
- 選取 [繼續]。
在 [設定新的 Web 應用程式] 對話方塊中：
- 確認：目標 Framework 設定為 .NET 7.0 (或更新版本)。
- 確認：[驗證] 設定為 [無驗證]。
- 確認：未勾選 [不要使用最上層陳述式]。
- 選取 [繼續]。
在 [設定新的 Web 應用程式] 對話方塊中：
- 針對 [專案名稱] 輸入 RazorPagesMovie。請務必將專案命名為 RazorPagesMovie (大小寫需相符)，如此，在您複製並貼上範例程式碼時命名空間才會相符。
- 選取建立。

執行應用程式

在方案總管中選取 [RazorPagesMovie]，然後按 Ctrl+F5 直接執行應用程式而不使用偵錯工具。

當專案尚未設定為使用 SSL 時，Visual Studio 會顯示下列對話方塊：

此專案設定為使用 SSL。為避免瀏覽器中的 SSL 警告，您可以選擇信任 IIS Express 產生的自我簽署憑證。您要信任 IIS Express SSL 憑證嗎？

如果您信任 IIS Express SSL 憑證，請選取 [是]。

此時會顯示下列對話方塊：

安全性警告對話方塊

若您同意信任開發憑證，請選取 [是]。

如需關於信任 Firefox 瀏覽器的資訊，請參閱 Firefox SEC_ERROR_INADEQUATE_KEY_USAGE 憑證錯誤。

Visual Studio：

執行會啟動 Kestrel 伺服器的應用程式。
在 https://localhost:<port> 啟動預設瀏覽器，以顯示應用程式 UI。 <port> 是應用程式建立時指派的隨機連接埠。

關閉瀏覽器視窗。

藉由執行下列命令來信任 HTTPS 開發憑證：
```
dotnet dev-certs https --trust
```
上述命令無法在 Linux 上使用。如需信任憑證的資訊，請參閱您的 Linux 發行版本文件。

若憑證先前不受信任，則上述命令會顯示下列對話方塊：
若您同意信任開發憑證，請選取 [是]。

如需詳細資訊，請參閱信任 ASP.NET Core HTTPS 開發憑證。

如需關於信任 Firefox 瀏覽器的資訊，請參閱 Firefox SEC_ERROR_INADEQUATE_KEY_USAGE 憑證錯誤。

在 Visual Studio Code 中，按 Ctrl+F5 (Windows) 或 ⌘+F5 (macOS)，以執行應用程式而不進行偵錯。

在 [選取偵錯工具] 提示字元中，選取 [.NET 5+ 和 .NET Core]。

選取環境對話方塊

使用下列 URL 啟動的預設瀏覽器：https://localhost:<port>，其中 <port> 是隨機產生的連接埠號碼。

關閉瀏覽器視窗。

在 Visual Studio Code 的 [執行] 功能表中，選取 [停止偵錯] 或按 [Shift]+[F5] 以停止應用程式。

檢查專案檔

以下幾節概要說明您將在後續的教學課程中使用的主要專案資料夾和檔案。

Pages 資料夾

包含 Razor 頁面和支援檔案。每個 Razor 頁面都是一組檔案：

一個 .cshtml 檔案，內含 HTML 標記和使用 Razor 語法的 C# 程式碼。
有 C# 程式碼可處理頁面事件的 .cshtml.cs 檔案。

wwwroot 資料夾

包含靜態資產，例如 HTML 檔案、JavaScript 檔案和 CSS 檔案。如需詳細資訊，請參閱 ASP.NET Core 中的靜態檔案。

`appsettings.json`

包含設定資料，例如連接字串。如需詳細資訊，請參閱 ASP.NET Core 中的組態。

Program.cs

包含下列程式碼：

var builder = WebApplication.CreateBuilder(args);

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

var app = builder.Build();

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

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

此檔案中的以下幾行程式碼會建立具有預設值的 WebApplicationBuilder，將 Razor Pages 支援新增至相依性插入 (DI) 容器，並建置應用程式：

var builder = WebApplication.CreateBuilder(args);

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

var app = builder.Build();

當應用程式並非以開發模式執行時，下列程式碼會將例外狀況端點設定為 /Error，並啟用 HTTP 嚴格的傳輸安全性通訊協定 (HSTS)：

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

例如，上述程式碼會在應用程式處於生產或測試模式時執行。如需詳細資訊，請參閱在 ASP.NET Core 中使用多個環境 (部分機器翻譯)。

下列程式碼會啟用多種不同的中介軟體：

app.UseHttpsRedirection();：將 HTTP 要求重新導向至 HTTPS。
app.UseStaticFiles();：允許提供靜態檔案，例如 HTML、CSS、影像和 JavaScript。如需詳細資訊，請參閱 ASP.NET Core 中的靜態檔案。
app.UseRouting();：將路由比對新增至中介軟體管線。如需詳細資訊，請參閱 ASP.NET Core 中的路由
app.MapRazorPages();：設定 Razor Pages 的端點路由。
app.UseAuthorization();：授權給使用者存取安全資源。此應用程式不使用授權，因此可以移除這一行。
app.Run();：執行應用程式。

使用已完成的範例進行疑難排解

若您遇到無法解決的問題，請將您的程式碼與已完成的專案進行比較。檢視或下載已完成的專案 (如何下載)。

下一步

下一步：新增模型

這是系列中的第一個教學課程，教導您建置 ASP.NET Core Razor Pages Web 應用程式的基本概念。

如需適用於熟悉控制器與檢視之開發人員的進階介紹，請參閱 Razor Pages 簡介。如需影片簡介，請參閱適用於初學者的 Entity Framework Core。

如果您不熟悉 ASP.NET Core 開發，且不確定哪些 ASP.NET Core web UI 解決方案最適合您的需求，請參閱選擇 ASP.NET Core UI。

在本系列結束時，您將會有一個可管理電影資料庫的應用程式。

在本教學課程中，您已：

建立 Razor Pages Web 應用程式。
執行應用程式。
檢查專案檔。

在本教學課程結束時，您將會有一個能夠運作的 Razor Pages Web 應用程式，且您將在後續的教學課程中予以加強。

Home 或索引頁面

必要條件

Visual Studio 2022 和 ASP.NET 與 Web 開發工作負載。
.NET 6.0 SDK

建立 Razor Pages Web 應用程式

啟動 Visual Studio 2022 並選取 [建立新專案]。
在 [建立新專案] 對話方塊中，選取 [ASP.NET Core Web 應用程式]，然後選取 [下一步]。
在 [設定新專案] 對話方塊中，輸入 RazorPagesMovie 作為 [專案名稱]。請務必將專案命名為 RazorPagesMovie (大小寫需相符)，如此，在您複製並貼上範例程式碼時命名空間才會相符。
選取 [下一步]。
在 [其他資訊] 對話方塊中，選取 [.NET 6.0 (長期支援)]，然後選取 [建立]。

下列起始專案會隨即建立：

方案總管

本教學課程假設您熟悉 VS Code。如需詳細資訊，請參閱 VS Code 使用者入門。

從 [終端機] 功能表中選取 [新增終端機]，以開啟整合式終端機。
變更為將會包含專案的目錄 (cd)。
執行下列命令：
```
dotnet new webapp -o RazorPagesMovie
code -r RazorPagesMovie
```
dotnet new 命令會在 RazorPagesMovie 資料夾中建立新的 Razor Pages 專案。

code 命令會在目前的 Visual Studio Code 執行個體中開啟 RazorPagesMovie 專案資料夾。

Visual Studio Code 會顯示對話方塊，詢問：您是否信任此資料夾中檔案的作者？

如果您信任父資料夾中的所有檔案，請選取 [信任父資料夾中所有檔案的作者]。
選取 [是，信任作者]，因為專案資料夾有 .NET 產生的檔案。
當 Visual Studio Code 要求您新增資產以建置和偵錯專案時，請選取 [是]。如果 Visual Studio Code 不提供新增建置和偵錯資產，請選取 [檢視]>[命令選擇區]，然後在搜尋方塊中輸入「.NET」。從命令清單中選取 .NET: Generate Assets for Build and Debug 命令。

Visual Studio Code 會新增 .vscode 資料夾，其中包含產生的 launch.json 和 tasks.json 檔案。

執行應用程式

在方案總管中選取 RazorPagesMovie，然後按 Ctrl+F5 直接執行而不使用偵錯工具。

當專案尚未設定為使用 SSL 時，Visual Studio 會顯示下列對話方塊：

此專案設定為使用 SSL。為避免瀏覽器中的 SSL 警告，您可以選擇信任 IIS Express 產生的自我簽署憑證。您要信任 IIS Express SSL 憑證嗎？

如果您信任 IIS Express SSL 憑證，請選取 [是]。

此時會顯示下列對話方塊：

安全性警告對話方塊

若您同意信任開發憑證，請選取 [是]。

如需關於信任 Firefox 瀏覽器的資訊，請參閱 Firefox SEC_ERROR_INADEQUATE_KEY_USAGE 憑證錯誤。

Visual Studio：

執行會啟動 Kestrel 伺服器的應用程式。
在 https://localhost:5001 啟動預設瀏覽器，以顯示應用程式 UI。

藉由執行下列命令來信任 HTTPS 開發憑證：
```
dotnet dev-certs https --trust
```
上述命令無法在 Linux 上使用。如需信任憑證的資訊，請參閱您的 Linux 發行版本文件。

若憑證先前不受信任，則上述命令會顯示下列對話方塊：
若您同意信任開發憑證，請選取 [是]。

如需詳細資訊，請參閱信任 ASP.NET Core HTTPS 開發憑證。

如需關於信任 Firefox 瀏覽器的資訊，請參閱 Firefox SEC_ERROR_INADEQUATE_KEY_USAGE 憑證錯誤。

在 Visual Studio Code 中，按 Ctrl+F5 以執行應用程式。在 [選取環境] 提示中，選取 [.NET Core]。

使用下列 URL 啟動的預設瀏覽器：https://localhost:5001

檢查專案檔

以下幾節概要說明您將在後續的教學課程中使用的主要專案資料夾和檔案。

Pages 資料夾

包含 Razor 頁面和支援檔案。每個 Razor 頁面都是一組檔案：

一個 .cshtml 檔案，內含 HTML 標記和使用 Razor 語法的 C# 程式碼。
有 C# 程式碼可處理頁面事件的 .cshtml.cs 檔案。

支援檔案的名稱以底線開頭。例如，_Layout.cshtml 檔案會設定所有頁面通用的 UI 元素。此檔案會設定頁面頂端的導覽功能表和頁面底部的著作權標示。如需詳細資訊，請參 ASP.NET 中的配置。

wwwroot 資料夾

包含靜態資產，例如 HTML 檔案、JavaScript 檔案和 CSS 檔案。如需詳細資訊，請參閱 ASP.NET Core 中的靜態檔案。

`appsettings.json`

包含設定資料，例如連接字串。如需詳細資訊，請參閱 ASP.NET Core 中的組態。

Program.cs

包含下列程式碼：

var builder = WebApplication.CreateBuilder(args);

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

var app = builder.Build();

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

app.UseRouting();

app.UseAuthorization();

app.MapRazorPages();

app.Run();

此檔案中的以下幾行程式碼會建立具有預設值的 WebApplicationBuilder，將 Razor Pages 支援新增至相依性插入 (DI) 容器，並建置應用程式：

var builder = WebApplication.CreateBuilder(args);

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

var app = builder.Build();

當應用程式並非以開發模式執行時，下列程式碼會將例外狀況端點設定為 /Error，並啟用 HTTP 嚴格的傳輸安全性通訊協定 (HSTS)：

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

例如，上述程式碼會在應用程式處於生產或測試模式時執行。如需詳細資訊，請參閱在 ASP.NET Core 中使用多個環境 (部分機器翻譯)。

下列程式碼會啟用多種不同的中介軟體：

app.UseHttpsRedirection();：將 HTTP 要求重新導向至 HTTPS。
app.UseStaticFiles();：允許提供靜態檔案，例如 HTML、CSS、影像和 JavaScript。如需詳細資訊，請參閱 ASP.NET Core 中的靜態檔案。
app.UseRouting();：將路由比對新增至中介軟體管線。如需詳細資訊，請參閱 ASP.NET Core 中的路由
app.MapRazorPages();：設定 Razor Pages 的端點路由。
app.UseAuthorization();：授權給使用者存取安全資源。此應用程式不使用授權，因此可以移除這一行。
app.Run();：執行應用程式。

使用已完成的範例進行疑難排解

若您遇到無法解決的問題，請將您的程式碼與已完成的專案進行比較。檢視或下載已完成的專案 (如何下載)。

下一步

下一步：新增模型

這是系列中的第一個教學課程，教導您建置 ASP.NET Core Razor Pages Web 應用程式的基本概念。

如需適用於熟悉控制器與檢視之開發人員的進階介紹，請參閱 Razor Pages 簡介。

如果您不熟悉 ASP.NET Core 開發，且不確定哪些 ASP.NET Core web UI 解決方案最適合您的需求，請參閱選擇 ASP.NET Core UI。

在本系列結束時，您將會有一個可管理電影資料庫的應用程式。

在本教學課程中，您已：

建立 Razor Pages Web 應用程式。
執行應用程式。
檢查專案檔。

在本教學課程結束時，您將會有一個能夠運作的 Razor Pages Web 應用程式，且您將在後續的教學課程中予以加強。

Home 或索引頁面

必要條件

Visual Studio 2019 16.8 或更新版本，其中包含 ASP.NET 和網頁程式開發工作負載
.NET 5.0 SDK

建立 Razor Pages Web 應用程式

啟動 Visual Studio 並選取 [建立新專案]。如需詳細資訊，請參閱在 Visual Studio 中建立新專案。
在 [建立新專案] 對話方塊中，選取 [ASP.NET Core Web 應用程式]，然後選取 [下一步]。
在 [設定新專案] 對話方塊中，輸入 RazorPagesMovie 作為 [專案名稱]。請務必將專案命名為 RazorPagesMovie (大小寫需相符)，如此，在您複製並貼上範例程式碼時命名空間才會相符。
選取建立。
在 [建立新的 ASP.NET Core Web 應用程式] 對話方塊中，選取：
1. 下拉式清單中的 .NET Core 和 ASP.NET Core 5.0。
2. Web 應用程式。
3. 建立。

下列起始專案會隨即建立：

方案總管

本教學課程假設您熟悉 VS Code。如需詳細資訊，請參閱 VS Code 使用者入門。

從 [終端機] 功能表中選取 [新增終端機]，以開啟整合式終端機。
變更為將會包含專案的目錄 (cd)。
執行下列命令：
```
dotnet new webapp -o RazorPagesMovie
code -r RazorPagesMovie
```
dotnet new 命令會在 RazorPagesMovie 資料夾中建立新的 Razor Pages 專案。

code 命令會在目前的 Visual Studio Code 執行個體中開啟 RazorPagesMovie 專案資料夾。

Visual Studio Code 會顯示對話方塊，詢問：您是否信任此資料夾中檔案的作者？

如果您信任父資料夾中的所有檔案，請選取 [信任父資料夾中所有檔案的作者]。
選取 [是，信任作者]，因為專案資料夾有 .NET 產生的檔案。
當 Visual Studio Code 要求您新增資產以建置和偵錯專案時，請選取 [是]。如果 Visual Studio Code 不提供新增建置和偵錯資產，請選取 [檢視]>[命令選擇區]，然後在搜尋方塊中輸入「.NET」。從命令清單中選取 .NET: Generate Assets for Build and Debug 命令。

Visual Studio Code 會新增 .vscode 資料夾，其中包含產生的 launch.json 和 tasks.json 檔案。

執行應用程式

按 Ctrl+F5 即可執行而不使用偵錯工具。

當專案尚未設定為使用 SSL 時，Visual Studio 會顯示下列對話方塊：

如果您信任 IIS Express SSL 憑證，請選取 [是]。

此時會顯示下列對話方塊：

若您同意信任開發憑證，請選取 [是]。

如需關於信任 Firefox 瀏覽器的資訊，請參閱 Firefox SEC_ERROR_INADEQUATE_KEY_USAGE 憑證錯誤。

Visual Studio 會啟動 IIS Express，並執行應用程式。位址列會顯示 localhost:port#，而不是類似於 example.com 的內容。這是因為 localhost 是本機電腦的標準主機名稱。 Localhost 只會為來自本機電腦的 Web 要求提供服務。當 Visual Studio 建立 Web 專案時，會為網頁伺服器使用隨機連接埠。

藉由執行下列命令來信任 HTTPS 開發憑證：
```
dotnet dev-certs https --trust
```
上述命令無法在 Linux 上使用。如需信任憑證的資訊，請參閱您的 Linux 發行版本文件。

若憑證先前不受信任，則上述命令會顯示下列對話方塊：
若您同意信任開發憑證，請選取 [是]。

如需詳細資訊，請參閱信任 ASP.NET Core HTTPS 開發憑證。

如需關於信任 Firefox 瀏覽器的資訊，請參閱 Firefox SEC_ERROR_INADEQUATE_KEY_USAGE 憑證錯誤。

按 Ctrl-F5 即可執行而不使用偵錯工具。

Visual Studio Code 會啟動 Kestrel、啟動瀏覽器，然後瀏覽至 http://localhost:5001。位址列會顯示 localhost:port#，而不是類似於 example.com 的內容。這是因為 localhost 是本機電腦的標準主機名稱。 Localhost 只會為來自本機電腦的 Web 要求提供服務。

選取 [執行]>[啟動但不偵錯] 來啟動應用程式。

Visual Studio for Mac：
- 啟動 Kestrel 伺服器。
- 啟動瀏覽器。
- 瀏覽至 http://localhost:port，其中 port 是隨機播放的連接埠號碼。
Visual Studio for Mac 會顯示下列快顯視窗：

若您信任開發憑證，請選取 [是]。

此時會顯示下列對話方塊：

輸入您的密碼，然後選取 [確定]

若您同意信任開發憑證，請選取 [是]。

如需詳細資訊，請參閱信任 ASP.NET Core HTTPS 開發憑證。
在 Visual Studio 中按 Opt-Cmd-Return，在沒有偵錯工具的情況下執行。或者，瀏覽到功能表列，然後前往 [執行]>[啟動但不偵錯]。

Visual Studio 會啟動 Kestrel、啟動瀏覽器，然後瀏覽至 http://localhost:5001。

檢查專案檔

以下概要說明主要專案資料夾和檔案，您將在稍後的教學課程中使用這些資料夾和檔案。

Pages 資料夾

包含 Razor 頁面和支援檔案。每個 Razor 頁面都是一組檔案：

一個 .cshtml 檔案，內含 HTML 標記和使用 Razor 語法的 C# 程式碼。
有 C# 程式碼可處理頁面事件的 .cshtml.cs 檔案。

wwwroot 資料夾

包含靜態資產，例如 HTML 檔案、JavaScript 檔案和 CSS 檔案。如需詳細資訊，請參閱 ASP.NET Core 中的靜態檔案。

`appsettings.json`

包含設定資料，例如連接字串。如需詳細資訊，請參閱 ASP.NET Core 中的組態。

Program.cs

包含應用程式的進入點。如需詳細資訊，請參閱 ASP.NET 中的 .NET 泛型主機。

Startup.cs

包含設定應用程式行為的程式碼。如需詳細資訊，請參閱 ASP.NET Core 中的應用程式啟動。

使用已完成的範例進行疑難排解

若您遇到無法解決的問題，請將您的程式碼與已完成的專案進行比較。檢視或下載已完成的專案 (如何下載)。

下一步

下一步：新增模型

這是系列中的第一個教學課程，教導您建置 ASP.NET Core Razor Pages Web 應用程式的基本概念。

如需適用於熟悉控制器與檢視之開發人員的進階介紹，請參閱 Razor Pages 簡介。

在本系列結束時，您將會有一個可管理電影資料庫的應用程式。

檢視或下載範例程式碼 (如何下載)。

在本教學課程中，您已：

建立 Razor Pages Web 應用程式。
執行應用程式。
檢查專案檔。

在本教學課程結束時，您將會有一個能夠運作的 Razor Pages Web 應用程式，且後續的教學課程將以此作為建置基礎。

Home 或 Index 頁面

必要條件

Visual Studio 2019 16.4 或更新版本，其中包含 ASP.NET 和網頁程式開發工作負載
.NET Core 3.1 SDK

建立 Razor Pages Web 應用程式

從 Visual Studio 的 [檔案] 功能表中，選取 [新增]>[專案] 。
建立新的 ASP.NET Core Web 應用程式並選取 [下一步]。
將專案命名為 RazorPagesMovie。請務必將專案命名為 RazorPagesMovie，如此，在您複製並貼上程式碼時名稱空間才會相符。
在下拉式清單中選取 [ASP.NET Core 3.1]，然後依序選取 [Web 應用程式] 和 [建立]。

選取 ASP.NET Core Web 應用程式

下列起始專案會隨即建立：

方案總管

開啟整合式終端機。
變更為將包含專案的目錄 (cd)。
執行下列命令：
```
dotnet new webapp -o RazorPagesMovie
code -r RazorPagesMovie
```
- dotnet new 命令會在 RazorPagesMovie 資料夾中建立新的 Razor Pages 專案。
- code 命令會在目前的 Visual Studio Code 執行個體中開啟 RazorPagesMovie 資料夾。
在狀態列的 OmniSharp 火焰圖示變成綠色之後，會有對話方塊詢問 'RazorPagesMovie' 缺少建置和偵錯所需的資產。新增它們嗎？選取 [是]。

.vscode 目錄 (其中包含 launch.json 和 tasks.json 檔案) 會新增至專案的根目錄。

如果 Visual Studio Code 未提供自動新增資產的功能，請參閱 ASP.NET Core Blazor 的工具中的 Linux 作業系統指引。

執行應用程式

按 Ctrl+F5 即可執行而不使用偵錯工具。

當專案尚未設定為使用 SSL 時，Visual Studio 會顯示下列對話方塊：

如果您信任 IIS Express SSL 憑證，請選取 [是]。

此時會顯示下列對話方塊：

若您同意信任開發憑證，請選取 [是]。

如需關於信任 Firefox 瀏覽器的資訊，請參閱 Firefox SEC_ERROR_INADEQUATE_KEY_USAGE 憑證錯誤。

Visual Studio 會啟動 IIS Express，並執行應用程式。位址列會顯示 localhost:port#，而不是類似於 example.com 的內容。這是因為 localhost 是本機電腦的標準主機名稱。 Localhost 只會為來自本機電腦的 Web 要求提供服務。當 Visual Studio 建立 Web 專案時，會為網頁伺服器使用隨機連接埠。

藉由執行下列命令來信任 HTTPS 開發憑證：
```
dotnet dev-certs https --trust
```
上述命令無法在 Linux 上使用。如需信任憑證的資訊，請參閱您的 Linux 發行版本文件。

若憑證先前不受信任，則上述命令會顯示下列對話方塊：
若您同意信任開發憑證，請選取 [是]。

如需詳細資訊，請參閱信任 ASP.NET Core HTTPS 開發憑證。

如需關於信任 Firefox 瀏覽器的資訊，請參閱 Firefox SEC_ERROR_INADEQUATE_KEY_USAGE 憑證錯誤。

按 Ctrl-F5 即可執行而不使用偵錯工具。

Visual Studio Code 會啟動 Kestrel、啟動瀏覽器，然後瀏覽至 http://localhost:5001。位址列會顯示 localhost:port#，而不是類似於 example.com 的內容。這是因為 localhost 是本機電腦的標準主機名稱。 Localhost 只會為來自本機電腦的 Web 要求提供服務。

選取 [執行]>[啟動但不偵錯] 來啟動應用程式。

Visual Studio for Mac：
- 啟動 Kestrel 伺服器。
- 啟動瀏覽器。
- 瀏覽至 http://localhost:port，其中 port 是隨機播放的連接埠號碼。
Visual Studio for Mac 會顯示下列快顯視窗：

若您信任開發憑證，請選取 [是]。

此時會顯示下列對話方塊：

輸入您的密碼，然後選取 [確定]

若您同意信任開發憑證，請選取 [是]。

如需詳細資訊，請參閱信任 ASP.NET Core HTTPS 開發憑證。
在 Visual Studio 中按 Opt-Cmd-Return，在沒有偵錯工具的情況下執行。或者，瀏覽到功能表列，然後前往 [執行]>[啟動但不偵錯]。

Visual Studio 會啟動 Kestrel、啟動瀏覽器，然後瀏覽至 http://localhost:5001。

檢查專案檔

以下概要說明主要專案資料夾和檔案，您將在稍後的教學課程中使用這些資料夾和檔案。

Pages 資料夾

包含 Razor 頁面和支援檔案。每個 Razor 頁面都是一組檔案：

一個 .cshtml 檔案，內含 HTML 標記和使用 Razor 語法的 C# 程式碼。
有 C# 程式碼可處理頁面事件的 .cshtml.cs 檔案。

wwwroot 資料夾

包含靜態檔案，例如 HTML 檔案、JavaScript 檔案和 CSS 檔案。如需詳細資訊，請參閱 ASP.NET Core 中的靜態檔案。

`appSettings.json`

包含設定資料，例如連接字串。如需詳細資訊，請參閱 ASP.NET Core 中的組態。

Program.cs

包含程式的進入點。如需詳細資訊，請參閱 ASP.NET 中的 .NET 泛型主機。

Startup.cs

包含設定應用程式行為的程式碼。如需詳細資訊，請參閱 ASP.NET Core 中的應用程式啟動。

下一步

下一步：新增模型

教學課程：開始使用 ASP.NET Core 中的 Razor Pages

必要條件

建立 Razor Pages Web 應用程式

執行應用程式

檢查專案檔

Pages 資料夾

wwwroot 資料夾

appsettings.json

Program.cs

使用已完成的範例進行疑難排解

下一步

必要條件

建立 Razor Pages Web 應用程式

執行應用程式

檢查專案檔

Pages 資料夾

wwwroot 資料夾

appsettings.json

Program.cs

使用已完成的範例進行疑難排解

下一步

必要條件

建立 Razor Pages Web 應用程式

執行應用程式

檢查專案檔

Pages 資料夾

wwwroot 資料夾

appsettings.json

Program.cs

使用已完成的範例進行疑難排解

下一步

必要條件

建立 Razor Pages Web 應用程式

執行應用程式

檢查專案檔

Pages 資料夾

wwwroot 資料夾

appsettings.json

Program.cs

Startup.cs

使用已完成的範例進行疑難排解

下一步

必要條件

建立 Razor Pages Web 應用程式

執行應用程式

檢查專案檔

Pages 資料夾

wwwroot 資料夾

appSettings.json

Program.cs

Startup.cs

下一步

意見反應

其他資源

`appsettings.json`

`appsettings.json`

`appsettings.json`

`appsettings.json`

`appSettings.json`