Nodes / AllNodes
Nodes:根節點集合,[Browsable(false)] 隱藏於設計器屬性格。
AllNodes:遞迴取得所有節點扁平清單,便於搜尋/遍歷。
IndentXML
[DefaultValue(false)]
[Description("生成 XML 是否縮排")]
[Category("Behavior")]
public bool IndentXML { get; set; }
true:XML 輸出含縮排,方便除錯,但增加頁面大小。
false (預設):壓縮輸出,正式部署建議關閉。
其他行為屬性
| 屬性 | 型別 | 說明 |
AutoScroll | bool | 是否自動顯示捲軸,false 強制不顯示 |
GenerateAtServer | bool | true 伺服端產生 HTML (負擔大、頁面大);false 客戶端 JS/XSLT 轉換 (輕量) |
DynamicLoadChildNodes | bool | true 啟用動態載入子節點 (AJAX 模式),需設定節點 XMLSource |
TagKey | HtmlTextWriterTag | 覆寫為 Div,最外層標籤為 <div> |
TreeNodeStyleString | string | 一般節點 CSS 樣式字串 |
SelectedNodeStyleString | string | 選中節點 CSS 樣式字串 |
屬性設計原則
- 善用
DefaultValue、Description、Category 屬性,提升設計器體驗。
Browsable(false) 隱藏內部集合屬性,避免設計器序列化錯誤。
- 行為開關屬性預設
false,確保預設安全、高效能。