TreeView.OnTreeNodePopulate(TreeNodeEventArgs) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
引发 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)
参数
包含事件数据的 TreeNodeEventArgs。
注解
有时,由于数据大小或依赖于用户输入的自定义内容,以静态方式预定义树结构是不切实际的。 因此,控件 TreeView 支持动态节点填充。
PopulateOnDemand当节点的 属性设置为 true
时,当节点展开时,将在运行时填充该节点。
若要动态填充节点,请先将节点的 属性设置为 PopulateOnDemandtrue
。 接下来,为 TreeNodePopulate 以编程方式填充节点的事件定义事件处理方法。 典型的事件处理方法从数据源检索节点数据,将数据放入节点结构中,然后将节点结构添加到 ChildNodes 要填充的节点的集合中。 通过将 对象添加到 TreeNode 父节点的集合来创建 ChildNodes 节点结构。
注意
PopulateOnDemand当节点的 属性设置为 true
时,必须动态填充节点。 不能以声明方式将另一个节点嵌套在它下面;否则,页面上将发生错误。
(Microsoft Internet Explorer 4.0 兼容浏览器和更高版本的) 支持的浏览器也可以利用客户端节点填充。 启用后,这允许控件在 TreeView 扩展该节点时动态填充客户端上的节点,从而避免需要发回服务器。 有关客户端节点填充的详细信息,请参阅 PopulateNodesFromClient。
引发事件时,将通过委托调用事件处理程序。 有关如何处理事件的详细信息,请参阅 处理和引发事件。
OnTreeNodePopulate 方法还允许派生类对事件进行处理而不必附加委托。 这是在派生类中处理事件的首选技术。
继承者说明
在派生类中重写 OnTreeNodePopulate(TreeNodeEventArgs) 方法时,请务必为基类调用 OnTreeNodePopulate(TreeNodeEventArgs) 方法,以便注册的委托接收事件。