TreeView.MaxDataBindDepth Propriedade

Definição

Espaço de Nomes:
System.Web.UI.WebControls
Assemblagem:
System.Web.dll

Obtém ou define o número máximo de níveis de árvore para se associar ao TreeView controlo.

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

Valor de Propriedade

Int32

O número máximo de níveis de árvore para ligar ao TreeView controlo. O padrão é -1, que associa todos os níveis da árvore na fonte de dados ao controlo.

Exceções

ArgumentOutOfRangeException

O valor selecionado é menor que -1.

Exemplos

Esta seção contém dois exemplos de código. O primeiro exemplo de código demonstra como usar a MaxDataBindDepth propriedade para ligar apenas os dois primeiros níveis de nós (profundidades 0 e 1) ao TreeView controlo. O segundo exemplo de código fornece dados XML de exemplo para o primeiro exemplo de código.

O exemplo de código seguinte demonstra como usar a MaxDataBindDepth propriedade para ligar apenas os dois primeiros níveis de nós (profundidades 0 e 1) ao TreeView controlo. Todos os níveis dos nós na fonte de dados são ignorados. Para que este exemplo funcione corretamente, deve copiar os dados XML de amostra, fornecidos após este exemplo de código, para um ficheiro chamado 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>

O exemplo de código seguinte fornece dados XML de exemplo para o exemplo de código anterior.

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

Observações

Ao ligar o TreeView controlo a uma fonte de dados, use a MaxDataBindDepth propriedade para limitar o número de níveis de árvore a ligar ao controlo. Por exemplo, definir esta propriedade para 2 vincula apenas o nó raiz e quaisquer nós que estejam imediatamente abaixo do nó raiz ao TreeView controlo. Todos os nós restantes na fonte de dados são ignorados.

Importante

Um utilizador malicioso pode criar um pedido de callback e obter dados para os nós do TreeView controlo que o programador da página não está a mostrar. Portanto, a segurança dos dados deve ser implementada pela fonte de dados. Não uses a MaxDataBindDepth propriedade para esconder dados.

O valor desta propriedade é armazenado no estado de visualização.

Aplica-se a

Ver também