ASP.NET 控件開發系列（四）：屬性序列化模式與設計器序列化可見性控制

控件屬性如何在 ASPX 標籤中持久化，由 PersistenceModeAttribute 決定四種模式；DesignerSerializationVisibility 控制屬性是否被設計器序列化。

PersistenceMode 四種模式對照

關鍵差異：EncodedInnerDefaultProperty vs InnerDefaultProperty

• EncodedInnerDefaultProperty：內容視為純文字，< 輸出為 <，不允許巢狀控件標籤
• InnerDefaultProperty：內容可包含可解析的控件標籤，允許巢狀控件

隱藏屬性不序列化

[DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
public string InternalCacheKey { get; set; }

• Hidden：不序列化至 ASPX、不顯示於 PropertyGrid
• Content：序列化物件內容（適用集合/複雜物件）
• Visible：預設，完整序列化

實戰：DropDownList Items 屬性雙重標記

[PersistenceMode(PersistenceMode.InnerProperty)]
[DefaultProperty("Items")]
public ListItemCollection Items { get; }

同時支援：

<asp:DropDownList>
  <asp:ListItem Value="1">項目一</asp:ListItem>  <!-- InnerProperty -->
</asp:DropDownList>

<asp:DropDownList Items="項目一,項目二" />  <!-- Attribute (需 TypeConverter) -->