Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

TreeView.TreeNodeDataBound Event

Note: This event is new in the .NET Framework version 2.0.

Occurs when a data item is bound to a node in the TreeView control.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

public event TreeNodeEventHandler TreeNodeDataBound
/** @event */
public void add_TreeNodeDataBound (TreeNodeEventHandler value)

/** @event */
public void remove_TreeNodeDataBound (TreeNodeEventHandler value)

JScript supports the use of events, but not the declaration of new ones.

The TreeNodeDataBound event is raised when a data item is bound to a node in the TreeView control. This allows you to provide an event-handling method that performs a custom routine whenever this event occurs.

For more information about handling events, see Consuming Events.

This section contains two code examples. The first code example demonstrates how to use the TreeNodeDataBound event to change the image for a node when some condition is met. The second code example provides sample XML data for the first code example.

The following code example demonstrates how to use the TreeNodeDataBound event to change the image for a node when some condition is met. For this example to work correctly, you must copy the sample XML data, provided after this code example, to a file named Book.xml. Also be sure to provide your own images for this example to display.


<%@ Page Language="C#" %>

<script runat="server">

  void Data_Bound(Object sender, TreeNodeEventArgs e)
  {

    // Give the Chapter 2 node a custom image. 
    if(e.Node.Text == "Chapter 2")
    {
      e.Node.ImageUrl="Custom.jpg";
    }

  }

</script>

<html>
  <body>
    <form runat="server">
    
      <h3>TreeView TreeNodeDataBound Example</h3>
    
      <asp:TreeView id="BookTreeView" 
        DataSourceID="BookXmlDataSource"
        LeafNodeImageUrl="Leaf.jpg"
        ParentNodeImageUrl="Parent.jpg"
        RootNodeImageUrl="Root.jpg"   
        OnTreeNodeDataBound="Data_Bound"
        runat="server">
         
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" TextField="Title"/>
          <asp:TreeNodeBinding DataMember="Chapter" TextField="Heading"/>
          <asp:TreeNodeBinding DataMember="Section" TextField="Heading"/>
        </DataBindings>
         
      </asp:TreeView>
      
      <asp:XmlDataSource id="BookXmlDataSource"  
        DataFile="Book.xml"
        runat="server">
      </asp:XmlDataSource>
    
    </form>
  </body>
</html>


The following code example provides sample XML data for the preceding code example.

<Book Title="Book Title">
    <Chapter Heading="Chapter 1">
        <Section Heading="Section 1">
        </Section>
        <Section Heading="Section 2">
        </Section>
    </Chapter>
    <Chapter Heading="Chapter 2">
        <Section Heading="Section 1">
        </Section>
    </Chapter>
</Book>

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

Show:
© 2014 Microsoft