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 данных.

Значение этого свойства хранится в состоянии представления.

Применяется к

См. также раздел

ExpandDepth