通过

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 属性隐藏数据。

此属性的值存储在视图状态中。

适用于

另请参阅