ASP.NET URL Rewrite 實戰教學：HttpModule 攔截 + 正則比對 + IIS 擴展對應

URL 重寫是 SEO 友善、使用者體驗、安全性隱藏技術細節的關鍵技術。本文以實作專案為例，示範如何使用微軟 `URLRewriter.dll` 搭配自訂 `HttpModule`，達成「任意 URL 重寫至 `.aspx` 帶參數頁面」的完整流程，含正則比對邏輯、Web.config 註冊、IIS 副檔名對應設定。

需求場景

使用者瀏覽：https://song2.cn/viewnews/2009/3/2.html
實際重寫：https://song2.cn/viewnews.aspx?id=2&year=2009&month=3

支援多筆規則、正則擷取群組參數 (`$1`, `$2`...)、預設導向錯誤頁。

實作步驟

1. 取得組件

下載 `URLRewriter.dll` (微軟官方 / CodePlex 歷史版本)，加入專案參考。

2. 建立自訂 HttpModule (類別庫專案)

using System;
using System.Web;
using URLRewriter;

namespace URL
{
    public class MyRewriter : BaseModuleRewriter
    {
        protected override void Rewrite(string requestedPath, HttpApplication app)
        {
            // 正則比對範例
            if (System.Text.RegularExpressions.Regex.IsMatch(requestedPath, 
                @"viewnews/(\d{4})/(\d{1,2})/(\d{1,2})\.html"))
            {
                var match = System.Text.RegularExpressions.Regex.Match(requestedPath,
                    @"viewnews/(\d{4})/(\d{1,2})/(\d{1,2})\.html");
                string id = match.Groups[3].Value;
                string year = match.Groups[1].Value;
                string month = match.Groups[2].Value;
                app.Context.RewritePath($"/viewnews.aspx?id={id}&year={year}&month={month}");
            }
            else
            {
                app.Context.RewritePath("/here.aspx"); // 預設/錯誤頁
            }
        }
    }
}

3. Web.config 註冊 HttpModule

<configuration>
  <system.web>
    <httpModules>
      <add type="URL.MyRewriter" name="URLRewriter" />
    </httpModules>
    <compilation debug="true" />
    <authentication mode="Windows" />
  </system.web>
</configuration>

IIS 7+ 整合模式** 需改註冊至 ``：

<system.webServer>
  <modules>
    <add name="URLRewriter" type="URL.MyRewriter" />
  </modules>
</system.webServer>

<configSections>
  <section name="RewriterConfig" 
           type="URLRewriter.Config.RewriterConfigSerializerSectionHandler, URLRewriter" />
</configSections>

<RewriterConfig>
  <Rules>
    <RewriterRule>
      <LookFor>~/Sell/(\d+)\.html</LookFor>
      <SendTo>~/Search/Search_Sell.aspx?id=$1</SendTo>
    </RewriterRule>
    <RewriterRule>
      <LookFor>~/Buy/(\d+)\.html</LookFor>
      <SendTo>~/Search/Search_Buy.aspx?id=$1</SendTo>
    </RewriterRule>
  </Rules>
</RewriterConfig>

<system.web>
  <httpHandlers>
    <add verb="*" path="*.aspx" type="URLRewriter.RewriterFactoryHandler, URLRewriter" />
  </httpHandlers>
</system.web>