打造 Windows Forms 自訂集合屬性元件：從基礎 CollectionEditor 到進階設計時體驗

在 Windows Forms 開發中，若需在屬性視窗編輯集合型別屬性（如過濾條件清單），預設的 CollectionEditor 雖能基本運作，但常面臨「僅產生區域變數、無法對應全域變數」、「繼承 Control 導致刪除控制項時變數不隨之移除」等痛點。本文以 TypedFilter 為例，示範如何實作可設計時序列化、支援自訂編輯器的集合屬性，並探討常見坑點與改進方向。

基礎實作：可設計時序列化的集合屬性

關鍵在於三個屬性標記：

• [Category("BusinessObjectControl")]：分類顯示；
• [DesignerSerializationVisibility(DesignerSerializationVisibility.Content)]：告知設計器序列化集合內容而非參考；
• [Editor(typeof(FilterCollectionEditor), typeof(UITypeEditor))]：指定自訂集合編輯器。

class 動態 : Label
{
    private List<TypedFilter> _filters = new List<TypedFilter>();

    [Category("BusinessObjectControl")]
    [DesignerSerializationVisibility(DesignerSerializationVisibility.Content)]
    [Editor(typeof(FilterCollectionEditor), typeof(UITypeEditor))]
    public List<TypedFilter> Filters
    {
        get { return _filters; }
        set { _filters = value; }
    }
}

public class TypedFilter
{
    private string _dataPropertyName = "Name";
    public string DataPropertyName { get { return _dataPropertyName; } set { _dataPropertyName = value; } }

    private int _value = 0;
    public int Value { get { return _value; } set { _value = value; } }

    public override string ToString() => _dataPropertyName + " = " + _value.ToString();
}

class FilterCollectionEditor : CollectionEditor
{
    public FilterCollectionEditor(Type type) : base(type) { }
}

常見問題與解決思路

1. 僅產生區域變數，無法對應全域/欄位變數

預設 CollectionEditor 建立項目時呼叫 CreateInstance，若型別無無參建構子或未正確初始化，設計器將只在編輯器內建立暫時物件，不會寫入表單程式碼。解決方式：

• 確保集合元素型別（如 TypedFilter）有 public 無參建構子；
• 在 FilterCollectionEditor 覆寫 CreateInstance，回傳正確初始化的實例；
• 若需對應現有欄位，可在表單 Load 事件手動同步，或實作 IComponent 讓設計器管理生命週期。

2. 讓集合元素繼承 Control 導致刪除控制項時變數殘留

若 TypedFilter : Control，設計器會將其視為元件並加入容器，刪除時僅移除視覺樹，不會清除集合參考。建議：

• 集合元素勿繼承 Control，改為純 POCO 類別；
• 若需設計時拖放行為，改用 Component 並搭配 IComponent、ISite 管理。