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雖然集合可以程式設計方式填入，但通常是以宣告方式設定。

若要以宣告方式設定樹狀節點系結：

在控制項的開頭和結束記號之間巢狀開啟和 <DataBindings> 結束記號 TreeView 。
將元素放在 <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 類別

定義

範例

備註

屬性

方法

明確介面實作

擴充方法

適用於

另請參閱

其他資源