TreeNodeBindingCollection.CopyTo(TreeNodeBinding[], Int32) Method

Reference

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Copies all the items from the TreeNodeBindingCollection object to a compatible one-dimensional array of TreeNodeBinding objects, starting at the specified index in the target array.

public:
 void CopyTo(cli::array <System::Web::UI::WebControls::TreeNodeBinding ^> ^ bindingArray, int index);

public void CopyTo (System.Web.UI.WebControls.TreeNodeBinding[] bindingArray, int index);

override this.CopyTo : System.Web.UI.WebControls.TreeNodeBinding[] * int -> unit

Public Sub CopyTo (bindingArray As TreeNodeBinding(), index As Integer)

Parameters

bindingArray: TreeNodeBinding[]

A zero-based array of TreeNodeBinding objects that receives the copied items from the TreeNodeBindingCollection.

index: Int32

The position in bindingArray at which to start receiving the copied content.

Examples

The following code example demonstrates how to use the CopyTo method to copy the contents of the DataBindings collection to an array.


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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void Page_Load(Object sender, EventArgs e)
  {

    // Create an array of TreeNodeBinding objects and then use the
    // CopyTo method to copy the contents of the DataBindings collection
    // to the array.
    TreeNodeBinding[] bindings = new TreeNodeBinding[BookTreeView.DataBindings.Count];
    BookTreeView.DataBindings.CopyTo(bindings, 0);

    // Iterate through the array and display the value of the text field
    // property of each TreeNodeBinding object.
    MessageLabel.Text = "The field names for each node level are: <br/>";

    foreach (TreeNodeBinding binding in bindings)
    {

      MessageLabel.Text += binding.TextField + "<br/>";

    }

  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>TreeNodeBindingCollection CopyTo Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeNodeBindingCollection CopyTo 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="Subject"/>
        </DataBindings>
         
      </asp:TreeView>
      
      <asp:XmlDataSource id="BookXmlDataSource"  
         DataFile="Book.xml"
         runat="server">
      </asp:XmlDataSource>
    
      <br/>
    
      <asp:Label id="MessageLabel" runat="server"/>
    
    </form>
  </body>
</html>


<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)

    ' Create an array of TreeNodeBinding objects and then use the
    ' CopyTo method to copy the contents of the DataBindings collection
    ' to the array.
    Dim bindings(BookTreeView.DataBindings.Count - 1) As TreeNodeBinding
    BookTreeView.DataBindings.CopyTo(bindings, 0)

    ' Iterate through the array and display the value of the text field
    ' property of each TreeNodeBinding object.
    MessageLabel.Text = "The field names for each node level are: <br/>"

    
    Dim binding As TreeNodeBinding
    For Each binding In bindings

      MessageLabel.Text &= binding.TextField & "<br/>"

    Next

  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>TreeNodeBindingCollection CopyTo Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeNodeBindingCollection CopyTo 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="Subject"/>
        </DataBindings>
         
      </asp:TreeView>
      
      <asp:XmlDataSource id="BookXmlDataSource"  
         DataFile="Book.xml"
         runat="server">
      </asp:XmlDataSource>
    
      <br/>
    
      <asp:Label id="MessageLabel" runat="server"/>
    
    </form>
  </body>
</html>

Remarks

Use the CopyTo method to copy the contents of the TreeNodeBindingCollection object into bindingArray. Items are copied starting at index. You can then use the array to access the items that are in the collection.

As an alternative, you can use the GetEnumerator method to create an enumerator that can be used to access the items in the collection.

Applies to

Jaa