共用方式為

TreeView.MaxDataBindDepth 屬性

定義

命名空間:
System.Web.UI.WebControls
組件:
System.Web.dll

取得或設定綁定 TreeView 到控制點的最大樹狀層數。

public:
 property int MaxDataBindDepth { int get(); void set(int value); };
public int MaxDataBindDepth { get; set; }
member this.MaxDataBindDepth : int with get, set
Public Property MaxDataBindDepth As Integer

屬性值

Int32

綁定 TreeView 到控制的最大樹層數。 預設值為 -1，將資料來源中的所有樹層級綁定到控制項。

例外狀況

ArgumentOutOfRangeException

所選值小於 -1。

範例

本節包含兩個程式代碼範例。 第一個程式碼範例示範如何利用該 MaxDataBindDepth 特性，將前兩個節點層級（深度 0 和 1）綁定到控制器 TreeView 上。 第二個程式碼範例提供了第一個範例的 XML 資料範例。

以下程式碼範例示範如何利用該 MaxDataBindDepth 特性，僅將前兩個節點層級（深度 0 和 1）綁定到控制器 TreeView 上。 資料來源中的所有節點層級都會被忽略。 為了讓此範例正常運作，您必須將範例 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 MaxDataBindDepth Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView MaxDataBindDepth Example</h3>
    
      <asp:TreeView id="BookTreeView"
        MaxDataBindDepth="1"  
        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 MaxDataBindDepth Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView MaxDataBindDepth Example</h3>
    
      <asp:TreeView id="BookTreeView"
        MaxDataBindDepth="1"  
        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>

以下程式碼範例提供了前述程式碼範例的 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>

備註

綁定 TreeView 控制項到資料來源時，請使用屬性 MaxDataBindDepth 限制綁定控制項的樹狀層級數量。 例如，將此屬性2設為僅綁定根節點及其緊鄰根節點下方的節點。TreeView 資料來源中剩餘的所有節點皆被忽略。

這很重要

惡意使用者可以建立回調請求，取得頁面開發者未顯示的控制節點 TreeView 資料。 因此，資料安全必須由資料來源來實作。 不要用這個 MaxDataBindDepth 屬性來隱藏資料。

此屬性的價值會儲存在視圖狀態。

適用於

另請參閱