ASP.NET 4.0 Web Forms 路由大幅簡化：從自訂 RouteHandler 到 MapPageRoute 宣告式配置

ASP.NET 3.5 SP1 引入路由機制，但 Web Forms 整合極其繁瑣：需自訂 IRouteHandler、解析參數存入 HttpContext.Items、手動回傳頁面實例。ASP.NET 4.0 透過 MapPageRoute 等助手方法，實現零自訂 Handler、宣告式配置、參數自動繫結，大幅降低門檻。本文詳細對比新舊做法並示範最佳實踐。

3.5 SP1 時代的痛苦：三步走流程

1. Global.asax 註冊路由：RouteTable.Routes.Add(new Route("Categories/{categoryName}", new CustomRouteHandler("~/ShowProducts.aspx")));
2. 實作 IRouteHandler：GetHttpHandler 中解析 RequestContext.RouteData.Values，存入 HttpContext.Items，回傳 BuildManager.CreateInstanceFromVirtualPath 建立的頁面實例。
3. 目標頁面讀取參數：string cat = Context.Items["categoryName"] as string;

ASP.NET 4.0 全新體驗：一行搞定

void Application_Start(object sender, EventArgs e)
{
    RouteTable.Routes.MapPageRoute("CategoryRoute", "Categories/{categoryName}", "~/ShowProducts.aspx");
}

自動獲得：

• 參數自動繫結至 Page.RouteData.Values["categoryName"]。
• 支援 RouteValueDictionary 預設值、約束條件 (Regex)、實體路由類別。
• 雙向路由：Page.GetRouteUrl("CategoryRoute", new { categoryName = "Beverages" }) 產生 /Categories/Beverages。

進階配置範例

// 帶約束：categoryName 僅限字母
RouteTable.Routes.MapPageRoute("CategoryRoute", 
    "Categories/{categoryName}", "~/ShowProducts.aspx", 
    false, 
    new RouteValueDictionary { { "categoryName", "All" } }, // 預設值
    new RouteValueDictionary { { "categoryName", "[a-zA-Z]+" } } // 約束
);

// 多參數巢狀路由
RouteTable.Routes.MapPageRoute("ProductDetail", 
    "Categories/{categoryName}/Products/{productId}", "~/ProductDetail.aspx",
    constraints: new RouteValueDictionary { { "productId", @"\d+" } });

目標頁面存取參數最佳實踐

protected void Page_Load(object sender, EventArgs e)
{
    string category = RouteData.Values["categoryName"] as string ?? "All";
    int productId = Convert.ToInt32(RouteData.Values["productId"] ?? "0");
    // 繫結資料...
}

遷移指南與注意事項

總結

ASP.NET 4.0 將路由從「專家級黑魔法」降維為「宣告式基礎設施」。新專務必採用 MapPageRoute；舊專案升級 4.0 時，建議漸進式替換自訂 Handler，獲得更清晰、可維護、SEO 友善的 URL 架構。