ASP.NET 頁面伺服器端深度解析：動態編譯、臨時檔案與原始碼探勘

ASP.NET 接收 .aspx 請求後，如何將標記轉為類別、編譯成組件、載入執行？生成的臨時檔案藏在哪？如何除錯動態生成的原始碼？本文帶您走進伺服器端「黑盒子」，並提供一個可即時檢視頁面編譯後類別原始碼的除錯工具原型。

ASP.NET 臨時檔案目錄結構

%WINDIR%\Microsoft.NET\Framework\v2.0.50727\Temporary ASP.NET Files
    \<應用程式虛擬路徑>
        \<隨機資料夾>
            \<組件名>.dll          // 編譯後組件
            \<組件名>.pdb          // 除錯符號
            \<頁面類別>.cs/.vb     // 動態生成的原始碼 (若 debug=true)
            \<其他使用者控件、母版頁等>.cs/.vb

從 .aspx 到類別：動態編譯管線

1. 解析：PageParser 解析 .aspx、.ascx、.master，建構控件樹。
2. 生成原始碼：每個頁面/控件生成一個繼承 Page/UserControl 的類別 (如 ASP.default_aspx)，覆寫 FrameworkInitialize() 建構控件樹，覆寫 Render() 輸出 HTML。
3. 編譯：BuildManager 呼叫編譯器 (csc.exe/vbc.exe) 產生組件。
4. 快取：組件載入 AppDomain，後續請求直接複用，除非來源檔案變更。
5. 執行：PageHandlerFactory 建立頁面實例，觸發生命週期事件，最終 Render(HtmlTextWriter) 輸出回應。

動態生成原始碼範例 (簡化)

namespace ASP {
    using System.Web;
    using System.Web.UI;
    public class default_aspx : Page {
        protected TextBox TextBox1;
        protected Button Button1;
        private void @__BuildControlTree(default_aspx @__ctrl) {
            IParserAccessor @__parser = ((IParserAccessor)(@__ctrl));
            @__parser.AddParsedSubObject(new LiteralControl("\r\n\r\n"));
            HtmlForm @__ctrl2 = this.@__BuildControlform1();
            @__parser.AddParsedSubObject(@__ctrl2);
            @__parser.AddParsedSubObject(new LiteralControl("\r\n\r\n\r\n"));
        }
        protected override void FrameworkInitialize() {
            base.FrameworkInitialize();
            this.@__BuildControlTree(this);
        }
    }
}

自製「動態原始碼檢視器」工具原型

public class DynamicSourceViewer : IHttpHandler
{
    public void ProcessRequest(HttpContext context)
    {
        string virtualPath = context.Request.QueryString["path"]; // e.g. ~/Default.aspx
        if (string.IsNullOrEmpty(virtualPath)) return;

        // 1. 觸發編譯 (若未編譯)
        BuildManager.GetCompiledType(virtualPath);

        // 2. 取得生成的原始碼檔案路徑
        string tempDir = HttpRuntime.CodegenDir; // Temporary ASP.NET Files 應用程式子目錄
        string[] csFiles = Directory.GetFiles(tempDir, "*.cs", SearchOption.AllDirectories);
        string targetFile = csFiles.FirstOrDefault(f => f.Contains("default_aspx")); // 簡易匹配

        if (targetFile != null)
        {
            string source = File.ReadAllText(targetFile);
            context.Response.ContentType = "text/plain; charset=utf-8";
            context.Response.Write(source);
        }
        else
        {
            context.Response.Write("Source not found. Ensure debug=true in web.config.");
        }
    }
    public bool IsReusable => false;
}

註冊：<add verb="*" path="DynamicSource.axd" type="DynamicSourceViewer" />，瀏覽 /DynamicSource.axd?path=~/Default.aspx 即見原始碼。

常見問題與避坑指南

結語

理解 ASP.NET 伺服器端動態編譯機制，不僅能解決疑難雜症，更能指導預編譯部署、除錯策略、效能調優。臨時檔案目錄是通往真相的入口，善用它，讓「黑盒子」透明化。