ASP.NET 開發者每天面對 .aspx、.ascx、.ashx 三種副檔名,但許多人僅知「大概用途」。本文從編譯模型、生命週期、重用機制、部署限制四大維度深度剖析,並給出實戰選型決策樹。
| 副檔名 | 全名 | 核心用途 | 繼承鏈 | 可直接透過 URL 存取 |
|---|---|---|---|---|
| .aspx | Web Form Page | 完整網頁、表單、Master Page | Page → TemplateControl → Control | 是 |
| .ascx | User Control | 可重用 UI 片段 (導航列、分頁器、表單區塊) | UserControl → TemplateControl → Control | 否 (預設被 web.config 封鎖) |
| .ashx | Web Handler | 輕量 HTTP 端點 (API、圖片、檔案、RSS) | 實作 IHttpHandler | 是 |
Page/UserControl 的類別原始碼,編譯成組件暫存於 Temporary ASP.NET Files。aspnet_compiler 或 VS「發布」預先編譯,提升首次請求速度並保護原始碼。.ascx 無法直接被 URL 呼叫,因 web.config 含 <httpHandlers> <add path="*.ascx" verb="*" type="System.Web.HttpForbiddenHandler" />。
<%@ WebHandler Class="X" %>),同樣動態編譯。CodeBehind 獨立類別,預編譯後直接載入組件,無標記解析開銷。.aspx: PreInit → Init → InitComplete → PreLoad → Load → Control Events → LoadComplete → PreRender → SaveStateComplete → Render → Unload
.ascx: 同 Page,但無 PreInit/Theme 等頁面級階段,隨宿主頁面生命週期
.ashx: 僅 ProcessRequest(HttpContext) 一個進入點,無生命週期事件
<%@ Register Src="~/Controls/Navigation.ascx" TagPrefix="uc" TagName="Nav" %>
<uc:Nav runat="server" ID="nav1" />
public class MyHandler : IHttpHandler
{
public bool IsReusable => true; // 無狀態可重用
public void ProcessRequest(HttpContext ctx) { ... }
}
IsReusable=true:單一實例服務所有請求,嚴禁 在類別層級保存請求相關狀態。IsReusable=false:每請求新建實例 (預設)。| 類型 | 預設 | 啟用方式 |
|---|---|---|
| .aspx | 支援 | 無需額外設定 |
| .ascx | 支援 (隨宿主頁面) | 無需額外設定 |
| .ashx | 不支援 | 實作 IRequiresSessionState (讀寫) 或 IReadOnlySessionState (唯讀) |
IRequiresSessionState 並設 IsReusable=false。public class TypedHandler : IHttpHandler, IRequiresSessionState
{
public bool IsReusable => false;
public void ProcessRequest(HttpContext context)
{
// 強型別存取 QueryString/Form/Session
var req = new HttpRequestWrapper(context.Request);
var resp = new HttpResponseWrapper(context.Response);
var session = new HttpSessionStateWrapper(context.Session);
string action = req.QueryString["action"];
if (action == "getUser")
{
var user = session["CurrentUser"] as UserDto;
resp.ContentType = "application/json";
resp.Write(Newtonsoft.Json.JsonConvert.SerializeObject(user));
}
}
}
.aspx 是「完整頁面」,.ascx 是「可重用 UI 元件」,.ashx 是「輕量 HTTP 端點」。理解三者編譯模型、生命週期、Session 支援差異,能在架構設計時做出正確選擇,避免濫用 .aspx 做 API 或濫用 .ashx 輸出複雜 HTML。