TreeView.OnTreeNodePopulate(TreeNodeEventArgs) 方法

  • 參考

定義

命名空間:
System.Web.UI.WebControls
組件:
System.Web.dll

引發 TreeNodePopulate 控制項的 TreeView 事件。

protected:
 virtual void OnTreeNodePopulate(System::Web::UI::WebControls::TreeNodeEventArgs ^ e);
protected virtual void OnTreeNodePopulate (System.Web.UI.WebControls.TreeNodeEventArgs e);
abstract member OnTreeNodePopulate : System.Web.UI.WebControls.TreeNodeEventArgs -> unit
override this.OnTreeNodePopulate : System.Web.UI.WebControls.TreeNodeEventArgs -> unit
Protected Overridable Sub OnTreeNodePopulate (e As TreeNodeEventArgs)

參數

e
TreeNodeEventArgs

包含事件資料的 TreeNodeEventArgs。

備註

有時候，由於相依于使用者輸入的資料大小或自訂內容，靜態預先定義樹狀結構並不實用。 因此， TreeView 控制項支援動態節點母體擴展。 PopulateOnDemand當節點的 屬性設定為 true 時，該節點會在節點展開時于執行時間填入。

若要動態填入節點，請先將 PopulateOnDemand 節點的 屬性設定為 true 。 接下來，為以程式設計方式填入節點的事件 TreeNodePopulate 定義事件處理方法。 典型的事件處理方法會從資料來源擷取節點資料、將資料放入節點結構，然後將節點結構新增至 ChildNodes 要填入之節點的集合。 節點結構是藉由將 物件新增 TreeNode 至 ChildNodes 父節點的集合來建立。

注意

PopulateOnDemand當節點的 屬性設定為 true 時，必須動態填入節點。 您無法以宣告方式將另一個節點巢狀于其下方;否則，頁面上會發生錯誤。

支援的瀏覽器 (Microsoft Internet Explorer 4.0 相容瀏覽器和更新版本) 也可以利用用戶端節點擴展。 啟用時，這可讓 TreeView 控制項在展開該節點時動態填入用戶端上的節點，這可防止需要回傳至伺服器。 如需用戶端節點母體擴展的詳細資訊，請參閱 PopulateNodesFromClient 。

引發事件會透過委派叫用此事件處理常式。 如需如何處理事件的詳細資訊，請參閱 處理和引發事件。

OnTreeNodePopulate 方法也允許衍生類別處理事件，而不用附加委派。 這是在衍生類別中處理事件的慣用技巧。

給繼承者的注意事項

在 OnTreeNodePopulate(TreeNodeEventArgs) 衍生類別中覆寫 方法時，請務必呼叫 OnTreeNodePopulate(TreeNodeEventArgs) 基類的 方法，讓已註冊的委派接收 事件。

適用於

另請參閱