ASP.NET Web Pages - 核心內建物件完整參考：Page、Request、Response、Server、Session 生命週期與實戰應用

Web Pages 執行期提供豐富的內建物件，封裝 HTTP 要求/回應、伺服器工具、頁面渲染管線、狀態管理等核心功能，掌握這些物件是開發動態網站的關鍵。

Page 物件：頁面渲染管線核心

常用方法

關鍵屬性

PageData / Page 動態資料共享機制

跨頁面、版面頁、部頁共享資料的兩種存取方式：

@* 內容頁設定 *@
@{
 PageData["Title"] = "產品列表";
 Page.Title = "產品列表"; // 動態屬性寫法 (相同效果)
 Page.MetaDescription = "最新產品資訊";
}

@* 版面頁讀取 *@
<title>@PageData["Title"] | MySite</title>
<meta name="description" content="@Page.MetaDescription" />

PageData 為字典式存取 (索引子)，Page** 為動態物件屬性存取，兩者操作同一底層資料。

Request 物件：HTTP 要求完整封裝

Response 物件：HTTP 回應控制

Server 物件：伺服器端工具方法

Session 與 Application 狀態管理

版面配置與區塊渲染實戰

內容頁 (_Layout.cshtml 為版面頁)

@{
 Layout = "~/Shared/_Layout.cshtml";
 Page.Title = "首頁";
}
@section HeaderContent {
 <h1>歡迎光臨</h1>
}
<p>主要內容區域...</p>
@section Scripts {
 <script src="~/scripts/home.js"></script>
}

版面頁 (_Layout.cshtml)

<!DOCTYPE html>
<html><head>
<title>@Page.Title | MySite</title>
@RenderSection("Scripts", required: false)
</head><body>
@RenderPage("~/Shared/_Header.cshtml")
@RenderBody()
@RenderPage("~/Shared/_Footer.cshtml")
@RenderSection("Scripts", required: false)
</body></html>

防止檔案被直接瀏覽：底線前綴慣例

檔案名稱以 _ 開頭 (如 _Layout.cshtml, _Header.cshtml, _AppStart.cshtml) 將被 ASP.NET 路由系統攔截，**禁止直接透過 URL 存取**，適用於：

• 版面配置頁面
• 部頁/部分視圖
• 全域初始化腳本
• 敏感設定檔

敏感資訊隔離：_AppStart.cshtml 最佳實務

@* ~/App_Data/_AppStart.cshtml (或根目錄 _AppStart.cshtml) *@
@{
 // 資料庫連線字串 (實際建議放 Web.config connectionStrings)
 // Database.ConnectionString = "...";

 // Email 設定
 WebMail.SmtpServer = "smtp.example.com";
 WebMail.UserName = "noreply@example.com";
 WebMail.Password = ConfigurationManager.AppSettings["EmailPassword"]; // 從加密設定讀取
 WebMail.From = "noreply@example.com";
 WebMail.EnableSsl = true;

 // 第三方 API 金鑰
 // 實際建議使用 Azure Key Vault / AWS Secrets Manager / 環境變數
}

生產環境**嚴禁**將密碼、API Key、連線字串硬編碼在原始碼中，請使用設定提供者、祕密管理服務或環境變數。