TreeView.OnTreeNodePopulate(TreeNodeEventArgs) 方法

定义

引发 TreeView 控件的 TreeNodePopulate 事件。

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时,当节点展开时,将在运行时填充该节点。

若要动态填充节点,请先将节点的 属性设置为 PopulateOnDemandtrue。 接下来,为 TreeNodePopulate 以编程方式填充节点的事件定义事件处理方法。 典型的事件处理方法从数据源检索节点数据,将数据放入节点结构中,然后将节点结构添加到 ChildNodes 要填充的节点的集合中。 通过将 对象添加到 TreeNode 父节点的集合来创建 ChildNodes 节点结构。

注意

PopulateOnDemand当节点的 属性设置为 true时,必须动态填充节点。 不能以声明方式将另一个节点嵌套在它下面;否则,页面上将发生错误。

(Microsoft Internet Explorer 4.0 兼容浏览器和更高版本的) 支持的浏览器也可以利用客户端节点填充。 启用后,这允许控件在 TreeView 扩展该节点时动态填充客户端上的节点,从而避免需要发回服务器。 有关客户端节点填充的详细信息,请参阅 PopulateNodesFromClient

引发事件时,将通过委托调用事件处理程序。 有关如何处理事件的详细信息,请参阅 处理和引发事件

OnTreeNodePopulate 方法还允许派生类对事件进行处理而不必附加委托。 这是在派生类中处理事件的首选技术。

继承者说明

在派生类中重写 OnTreeNodePopulate(TreeNodeEventArgs) 方法时,请务必为基类调用 OnTreeNodePopulate(TreeNodeEventArgs) 方法,以便注册的委托接收事件。

适用于

另请参阅