TreeNodeBindingCollection 类

参考

定义

命名空间:: System.Web.UI.WebControls

程序集:: System.Web.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

表示 TreeNodeBinding 控件中 TreeView 对象的集合。此类不能被继承。

public ref class TreeNodeBindingCollection sealed : System::Web::UI::StateManagedCollection

public sealed class TreeNodeBindingCollection : System.Web.UI.StateManagedCollection

type TreeNodeBindingCollection = class
    inherit StateManagedCollection

Public NotInheritable Class TreeNodeBindingCollection
Inherits StateManagedCollection

继承: Object

StateManagedCollection
TreeNodeBindingCollection

示例

本部分包含两个代码示例。第一个代码示例演示如何以声明方式填充 TreeNodeBindingCollection 对象。第二个代码示例演示如何以编程方式填充 TreeNodeBindingCollection 对象。

下面的代码示例演示如何以声明方式填充 TreeNodeBindingCollection 对象。若要使此示例正常工作，必须将位于本部分末尾的 XML 数据复制到名为“Book.xml”的文件。


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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>TreeView XML Data Binding Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView XML Data Binding 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>


<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>TreeView XML Data Binding Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView XML Data Binding 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>

下面的代码示例演示如何以编程方式填充 TreeNodeBindingCollection 对象。若要使此示例正常工作，必须将位于本部分末尾的示例 XML 数据复制到名为“Book.xml”的文件。


<%@ 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 a new TreeView control.
    TreeView NewTree = new TreeView();

    // Set the properties of the TreeView control.
    NewTree.ID = "BookTreeView";
    NewTree.DataSourceID = "BookXmlDataSource";

    // Create the tree node binding relationship.

    // Create the root node binding.
    TreeNodeBinding RootBinding = new TreeNodeBinding();
    RootBinding.DataMember = "Book";
    RootBinding.TextField = "Title";

    // Create the parent node binding.
    TreeNodeBinding ParentBinding = new TreeNodeBinding();
    ParentBinding.DataMember = "Chapter";
    ParentBinding.TextField = "Heading";

    // Create the leaf node binding.
    TreeNodeBinding LeafBinding = new TreeNodeBinding();
    LeafBinding.DataMember = "Section";
    LeafBinding.TextField = "Heading";

    // Add bindings to the DataBindings collection.
    NewTree.DataBindings.Add(RootBinding);
    NewTree.DataBindings.Add(ParentBinding); 
    NewTree.DataBindings.Add(LeafBinding);

    // Manually register the event handler for the SelectedNodeChanged event.
    NewTree.SelectedNodeChanged += new EventHandler(this.Node_Change);

    // Add the TreeView control to the Controls collection of the PlaceHolder control.
    ControlPlaceHolder.Controls.Add(NewTree);

  }

  void Node_Change(Object sender, EventArgs e)
  {

    // Retrieve the TreeView control from the Controls collection of the PlaceHolder control.
    TreeView LocalTree = (TreeView)ControlPlaceHolder.FindControl("BookTreeView");

    // Display the selected node.
    Message.Text = "You selected: " + LocalTree.SelectedNode.Text;

  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>TreeView Constructor Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView Constructor Example</h3>
      
      <asp:PlaceHolder id="ControlPlaceHolder" runat="server">
      </asp:PlaceHolder>
   
      <asp:XmlDataSource id="BookXmlDataSource"  
        DataFile="Book.xml"
        runat="server">
      </asp:XmlDataSource>
      
      <br /><br />
      
      <asp:Label id="Message" 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 a new TreeView control.
    Dim NewTree As New TreeView

    ' Set the properties of the TreeView control.
    NewTree.ID = "BookTreeView"
    NewTree.DataSourceID = "BookXmlDataSource"

    ' Create the tree node binding relationship.

    ' Create the root node binding.
    Dim RootBinding As New TreeNodeBinding
    RootBinding.DataMember = "Book"
    RootBinding.TextField = "Title"

    ' Create the parent node binding.
    Dim ParentBinding As New TreeNodeBinding
    ParentBinding.DataMember = "Chapter"
    ParentBinding.TextField = "Heading"

    ' Create the leaf node binding.
    Dim LeafBinding As New TreeNodeBinding
    LeafBinding.DataMember = "Section"
    LeafBinding.TextField = "Heading"

    ' Add bindings to the DataBindings collection.
    NewTree.DataBindings.Add(RootBinding)
    NewTree.DataBindings.Add(ParentBinding)
    NewTree.DataBindings.Add(LeafBinding)

    ' Manually register the event handler for the SelectedNodeChanged event.
    AddHandler NewTree.SelectedNodeChanged, AddressOf Node_Change

    ' Add the TreeView control to the Controls collection of the PlaceHolder control.
    ControlPlaceHolder.Controls.Add(NewTree)

  End Sub

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

    ' Retrieve the TreeView control from the Controls collection of the PlaceHolder control.
    Dim LocalTree As TreeView = CType(ControlPlaceHolder.FindControl("BookTreeView"), TreeView)

    ' Display the selected node.
    Message.Text = "You selected: " & LocalTree.SelectedNode.Text

  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>TreeView Constructor Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView Constructor Example</h3>
      
      <asp:PlaceHolder id="ControlPlaceHolder" runat="server">
      </asp:PlaceHolder>
   
      <asp:XmlDataSource id="BookXmlDataSource"  
        DataFile="Book.xml"
        runat="server">
      </asp:XmlDataSource>
      
      <br /><br />
      
      <asp:Label id="Message" runat="server"/>
    
    </form>
  </body>
</html>

下面是上述代码示例的 XML 数据。

<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>

注解

该TreeNodeBindingCollection类用于在控件中TreeView存储和管理对象的集合TreeNodeBinding。控件 TreeView 将 TreeNodeBindingCollection 类用于其 DataBindings 属性。

该 DataBindings 属性包含定义 TreeNodeBinding 数据项与要绑定到的节点之间的关系的对象。绑定到数据源时，每个数据项包含多个属性 (（例如具有多个属性的 XML 元素）) ，节点将默认显示数据项方法返回 ToString 的值。对于 XML 元素，节点将显示元素名称，该名称显示树的基础结构，但不十分有用。可以通过指定树节点绑定将节点绑定到特定数据项属性。 DataBindings虽然集合可以以编程方式填充，但通常以声明方式设置该集合。

若要以声明方式设置树节点绑定，

在控件的TreeView开始标记和结束标记之间嵌套打开和<DataBindings>结束标记。
将元素放在 <asp:TreeNodeBinding> 要指定的每个树节点绑定的开始标记和结束 <DataBindings> 标记之间。

可以通过添加和删除TreeNodeBinding对象以编程方式管理对象TreeNodeBindingCollection。若要将 TreeNodeBinding 对象添加到集合，请使用 Add 或 Insert 方法。若要从集合中删除节点，请使用Remove或RemoveAt StateManagedCollection.Clear方法。

该 TreeNodeBindingCollection 类支持多种访问集合中项的方法：

Item[]使用索引器直接在特定的从零开始的索引处检索TreeNode对象。
使用该方法 StateManagedCollection.GetEnumerator 创建可用于循环访问集合的枚举器。

属性

Count	获取 StateManagedCollection 集合中包含的元素的数量。 (继承自 StateManagedCollection)
Item[Int32]	获取或设置 TreeNodeBinding 对象中指定索引处的 TreeNodeBindingCollection 对象。

方法

Add(TreeNodeBinding)	将指定的 TreeNodeBinding 对象追加到 TreeNodeBindingCollection 对象的结尾。
Clear()	从 StateManagedCollection 集合中删除所有项。 (继承自 StateManagedCollection)
Contains(TreeNodeBinding)	确定指定的 TreeNodeBinding 对象是否在集合中。
CopyTo(Array, Int32)	从特定的数组索引开始，将 StateManagedCollection 集合的元素复制到数组中。 (继承自 StateManagedCollection)
CopyTo(TreeNodeBinding[], Int32)	从目标数组的指定索引开始，将 TreeNodeBindingCollection 对象中的所有项复制到 TreeNodeBinding 对象的一维兼容数组。
CreateKnownType(Int32)	在派生类中替代时，创建实现 IStateManager 的类的实例。所创建对象的类型基于由 GetKnownTypes() 方法返回的集合的指定成员。 (继承自 StateManagedCollection)
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetEnumerator()	返回循环访问 StateManagedCollection 集合的迭代器。 (继承自 StateManagedCollection)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetKnownTypes()	在派生类中替代时，获取 StateManagedCollection 集合可以包含的 IStateManager 类型的数组。 (继承自 StateManagedCollection)
GetType()	获取当前实例的 Type。 (继承自 Object)
IndexOf(TreeNodeBinding)	确定集合中指定 TreeNodeBinding 对象的索引。
Insert(Int32, TreeNodeBinding)	将指定的 TreeNodeBinding 对象插入 TreeNodeBindingCollection 对象中的指定索引位置。
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
OnClear()	在派生类中替代时，在 Clear() 方法从集合中删除所有项之前执行附加工作。 (继承自 StateManagedCollection)
OnClearComplete()	在派生类中替代时，在 Clear() 方法完成从集合中删除所有项之后执行附加工作。 (继承自 StateManagedCollection)
OnInsert(Int32, Object)	在派生类中替代时，在 IList.Insert(Int32, Object) 或 IList.Add(Object) 方法向集合中添加项之前执行附加工作。 (继承自 StateManagedCollection)
OnInsertComplete(Int32, Object)	在派生类中替代时，在 IList.Insert(Int32, Object) 或 IList.Add(Object) 方法向集合中添加项之后执行附加工作。 (继承自 StateManagedCollection)
OnRemove(Int32, Object)	在派生类中替代时，在 IList.Remove(Object) 或 IList.RemoveAt(Int32) 方法从集合中删除指定项之前执行附加工作。 (继承自 StateManagedCollection)
OnRemoveComplete(Int32, Object)	在派生类中替代时，在 IList.Remove(Object) 或 IList.RemoveAt(Int32) 方法从集合中删除指定项之后执行附加工作。 (继承自 StateManagedCollection)
OnValidate(Object)	在派生类中替代时，验证 StateManagedCollection 集合的一个元素。 (继承自 StateManagedCollection)
Remove(TreeNodeBinding)	从 TreeNodeBinding 对象中移除指定的 TreeNodeBindingCollection 对象。
RemoveAt(Int32)	从 TreeNodeBinding 对象中移除指定索引位置的 TreeNodeBindingCollection 对象。
SetDirty()	强制将整个 StateManagedCollection 集合序列化为视图状态。 (继承自 StateManagedCollection)
SetDirtyObject(Object)	在派生类中替代时，指示集合包含的 `object` 将其全部状态记录到视图状态，而不是仅记录更改信息。 (继承自 StateManagedCollection)
ToString()	返回表示当前对象的字符串。 (继承自 Object)

显式接口实现

ICollection.Count	获取 StateManagedCollection 集合中包含的元素的数量。 (继承自 StateManagedCollection)
ICollection.IsSynchronized	获取指示 StateManagedCollection 集合是否已同步(线程安全)的值。此方法在所有情况下均返回 `false`。 (继承自 StateManagedCollection)
ICollection.SyncRoot	获取可用于同步对 StateManagedCollection 集合的访问的对象。此方法在所有情况下均返回 `null`。 (继承自 StateManagedCollection)
IEnumerable.GetEnumerator()	返回循环访问 StateManagedCollection 集合的迭代器。 (继承自 StateManagedCollection)
IList.Add(Object)	向 StateManagedCollection 集合中添加一个项。 (继承自 StateManagedCollection)
IList.Clear()	从 StateManagedCollection 集合中删除所有项。 (继承自 StateManagedCollection)
IList.Contains(Object)	确定 StateManagedCollection 集合中是否包含特定值。 (继承自 StateManagedCollection)
IList.IndexOf(Object)	确定 StateManagedCollection 集合中的指定项的索引。 (继承自 StateManagedCollection)
IList.Insert(Int32, Object)	将项在指定索引处插入 StateManagedCollection 集合中。 (继承自 StateManagedCollection)
IList.IsFixedSize	获取指示 StateManagedCollection 集合是否具有固定大小的值。此方法在所有情况下均返回 `false`。 (继承自 StateManagedCollection)
IList.IsReadOnly	获取指示 StateManagedCollection 集合是否为只读的值。 (继承自 StateManagedCollection)
IList.Item[Int32]	获取指定索引处的 IStateManager 元素。 (继承自 StateManagedCollection)
IList.Remove(Object)	从 StateManagedCollection 集合中删除指定对象的第一个匹配项。 (继承自 StateManagedCollection)
IList.RemoveAt(Int32)	删除指定索引处的 IStateManager 元素。 (继承自 StateManagedCollection)
IStateManager.IsTrackingViewState	获取指示 StateManagedCollection 集合是否保存对其视图状态的更改的值。 (继承自 StateManagedCollection)
IStateManager.LoadViewState(Object)	还原 StateManagedCollection 集合以及其包含的 IStateManager 项的以前保存的视图状态。 (继承自 StateManagedCollection)
IStateManager.SaveViewState()	保存自页回发到服务器后对 StateManagedCollection 集合和该集合包含的每个 IStateManager 对象所做的更改。 (继承自 StateManagedCollection)
IStateManager.TrackViewState()	使 StateManagedCollection 集合及其包含的每个 IStateManager 对象跟踪对它们的视图状态所做的更改，以使它们可以在相同页的请求之间得以保持。 (继承自 StateManagedCollection)

扩展方法

Cast<TResult>(IEnumerable)	将 IEnumerable 的元素强制转换为指定的类型。
OfType<TResult>(IEnumerable)	根据指定类型筛选 IEnumerable 的元素。
AsParallel(IEnumerable)	启用查询的并行化。
AsQueryable(IEnumerable)	将 IEnumerable 转换为 IQueryable。

适用于

TreeNodeBindingCollection 类

定义

示例

注解

属性

方法

显式接口实现

扩展方法

适用于

另请参阅

其他资源