This documentation is archived and is not being maintained.

TreeNodeBindingCollection.Add Method

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

Appends the specified TreeNodeBinding object to the end of the TreeNodeBindingCollection object.

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

public int Add (
	TreeNodeBinding binding
)
public int Add (
	TreeNodeBinding binding
)
public function Add (
	binding : TreeNodeBinding
) : int

Parameters

binding

The TreeNodeBinding to append.

Return Value

The zero-based index of the location of the added TreeNodeBinding in the TreeNodeBindingCollection.

Use the Add method to append the specified TreeNodeBinding object to the end of the TreeNodeBindingCollection object.

As an alternative, you can insert a TreeNodeBinding object in the TreeNodeBindingCollection at a specific index using the Insert method.

The following code example demonstrates how to use the Add method to add a new TreeNodeBinding object programmatically to a TreeNodeBindingCollection object. For this example to work correctly, you must copy the XML data that is located at the end of this section to a file called Book.xml.


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

<script runat="server">

  void Page_Load(Object sender, EventArgs e)
  {

    // Use the Remove method to remove the TreeNodeBinding object
    // for the third-level nodes (index 2).
    TreeNodeBinding oldBinding = BookTreeView.DataBindings[2];
    BookTreeView.DataBindings.Remove(oldBinding);

    // Create a new TreeNodeBinding object and set its properties.
    TreeNodeBinding newBinding = new TreeNodeBinding();
    newBinding.DataMember = "Section";
    newBinding.TextField = "Subject";

    // Use the Add method to add the TreeNodeBinding object to the 
    // DataBindings collection.
    BookTreeView.DataBindings.Add(newBinding);

  }

</script>

<html>
  <body>
    <form runat="server">
    
      <h3>TreeNodeBindingCollection Add and Remove Example</h3>
    
      <asp:TreeView id="BookTreeView" 
        DataSourceID="BookXmlDataSource"
        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 is the XML data for the preceding code example.

<Book Title="Book Title">
    <Chapter Heading="Chapter 1">
        <Section Heading="Section 1"
            Subject="Subject 1">
        </Section>
        <Section Heading="Section 2"
            Subject="Subject 1">
        </Section>
    </Chapter>
    <Chapter Heading="Chapter 2">
        <Section Heading="Section 1"
            Subject="Subject 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
Show: