解決 Visual Studio 設計時「呈現控件時出錯」的根因與對策

前言

開發自訂控制項時，設計介面常出現「呈現控件時出錯：未將物件參考設定為物件的實例」，但編譯與執行皆正常。本文分析設計時、編譯時、執行時差異，並提供修正範例。

三大時期區別

• 設計時：Visual Studio 設計介面模擬控制項輸出。
• 編譯時：型別檢查、語法驗證。
• 執行時：真實 HTTP 請求處理，含例外與邏輯錯誤。

錯誤根因

設計時 VS 呼叫 Render/RenderContents，若程式碼存取未初始化的物件（如 Page.Server、子控制項），即拋出 NullReferenceException。

實際案例

protected override void RenderContents(HtmlTextWriter writer)
{
    UpButton.Text = Page.Server.HtmlDecode(UpButton.Text); // 設計時 Page 為 null
    DownButton.Text = Page.Server.HtmlDecode(DownButton.Text);
    base.RenderContents(writer);
}

欄位初始化：

private string upButtonText = "∧";
private string downButtonText = "∨";

修正模式

1. 防禦性檢查：if (DesignMode || Page == null) return;
2. 延遲初始化：在 EnsureChildControls 或 OnPreRender 設定屬性。
3. 使用 DesignMode 屬性區分環境。

修正後程式碼

protected override void RenderContents(HtmlTextWriter writer)
{
    if (DesignMode) { base.RenderContents(writer); return; }
    UpButton.Text = Page.Server.HtmlDecode(UpButton.Text);
    DownButton.Text = Page.Server.HtmlDecode(DownButton.Text);
    base.RenderContents(writer);
}

總結

設計時錯誤源於模擬環境缺少執行期上下文。養成 DesignMode 判斷與延遲初始化習慣，可徹底消除此類干擾。