ASP.NET 伺服器控制項開發核心：控制項生命週期 11 階段深度解析

掌握 **伺服器控制項生命週期** 是開發高品質自訂控制項、解決 ViewState 問題、效能優化的基石。ASP.NET 頁面與控制項共享同一生命週期管線，控制項在各階段的行為與責任截然不同。以下系統解析 11 大階段，附關鍵方法、最佳實務與常見錯誤。

生命週期 11 階段對照表

關鍵階段深度解析

Init 階段：控制項樹建構

protected override void OnInit(EventArgs e)
{
    base.OnInit(e); // 必須呼叫基底
    
    // 1. 建立子控制項 (確保 ID 固定，利於 ViewState 對應)
    _txtName = new TextBox { ID = "txtName" };
    _btnSubmit = new Button { ID = "btnSubmit", Text = "送出" };
    _btnSubmit.Click += BtnSubmit_Click;
    
    // 2. 加入控制項集合
    Controls.Add(_txtName);
    Controls.Add(_btnSubmit);
    
    // 3. 開始追蹤 ViewState (基底已呼叫 TrackViewState)
    // 覆寫 TrackViewState 僅在複雜屬性 (如自訂集合) 時需要
}

LoadViewState / SaveViewState：自訂狀態持久化

[Serializable]
private class CustomState
{
    public Dictionary DynamicProperties { get; set; }
    public List SelectedIds { get; set; }
}

private CustomState _state = new CustomState();

protected override object SaveViewState()
{
    // 回傳物件將自動序列化進 ViewState
    return new Pair(base.SaveViewState(), _state);
}

protected override void LoadViewState(object savedState)
{
    if (savedState == null) return;
    var pair = (Pair)savedState;
    base.LoadViewState(pair.First);
    _state = (CustomState)pair.Second;
}

PreRender：最後修改狀態的黃金窗口

protected override void OnPreRender(EventArgs e)
{
    base.OnPreRender(e);
    
    // 1. 確保子控制項已建立 (CreateChildControls)
    EnsureChildControls();
    
    // 2. 註冊客戶端腳本 (位置正確、不重複)
    if (!Page.ClientScript.IsClientScriptBlockRegistered(GetType(), "MyControlScript"))
    {
        Page.ClientScript.RegisterClientScriptBlock(GetType(), "MyControlScript", 
            "function myFunc() { ... }", true);
    }
    
    // 3. 最後調整屬性、資料繫結結果
    if (DataSource != null && !_dataBound)
    {
        DataBind();
        _dataBound = true;
    }
}

Render：輸出 HTML 最佳實務

protected override void Render(HtmlTextWriter writer)
{
    // 1. 使用 Writer 方法，支援縮排、編碼、屬性編碼
    writer.AddAttribute(HtmlTextWriterAttribute.Id, ClientID);
    writer.AddAttribute(HtmlTextWriterAttribute.Class, "my-control");
    writer.RenderBeginTag(HtmlTextWriterTag.Div);
    
    // 2. 讓子控制項自我渲染
    _txtName.RenderControl(writer);
    _btnSubmit.RenderControl(writer);
    
    writer.RenderEndTag(); //