C# 發現之旅：高效能 ASP.NET TreeView 控制項 (上) — RenderContents 核心渲染邏輯

RenderContents 角色

控制項 Render 呼叫 base.Render，內部再呼叫 RenderContents 輸出內容。覆寫此方法可完全掌控 HTML 輸出，是 TreeView 控制項核心邏輯所在。

設計模式偵測

if (base.Page.Site != null && base.Page.Site.DesignMode) {
    // 設計模式：僅輸出控制項中繼資訊
    Type t = this.GetType();
    writer.WriteLine("" + this.ID + "");
    writer.WriteLine("
Type=" + t.FullName);
    writer.WriteLine("
Version=" + t.Assembly.FullName);
    writer.WriteLine("
GenerateAtServer=" + this.GenerateAtServer);
    writer.WriteLine("
DynamicLoadChildNodes=" + this.DynamicLoadChildNodes);
    writer.WriteLine("
AutoScroll=" + this.AutoScroll);
    writer.WriteLine("
IndentXML=" + this.IndentXML);
    writer.WriteLine("
Yfyuan release at 2008-02-19");
    return;
}

• DesignMode=true 表示在 VS.NET 設計器中，不輸出實際樹狀結構，避免設計時效能負擔。
• 輸出型別、版本、關鍵屬性值，方便開發者確認設定。

執行模式：動態載入子節點腳本註冊

• 啟用 DynamicLoadChildNodes 時，輸出支援客戶端動態載入的 HTML/JS 區塊。
• 使用 RegisterStartupScript 在 </form> 前輸出，確保 DOM 就緒。

關鍵限制：Render 階段不可用 RegisterClientScriptBlock

在 Render/RenderContents 中呼叫 RegisterClientScriptBlock 無效，因 <form> 已開始輸出，無法插入 <head> 區塊。腳本註冊應在 OnLoad 或 Load 事件完成。

架構啟示

• 區分設計/執行模式，提升設計器體驗。
• 腳本/樣式註冊時機選擇直接影響頁面正確性。
• 動態載入功能採用啟動腳本延遲執行，降低首屏渲染負擔。