Compartir a través de

TreeView.MaxDataBindDepth Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

Obtiene o establece el número máximo de niveles del árbol a enlazar al control 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

Valor de propiedad

Int32

El número máximo de niveles del árbol a enlazar al control TreeView. El valor predeterminado es -1, que enlaza al control todos los niveles del árbol del origen de datos.

Excepciones

ArgumentOutOfRangeException

El valor seleccionado es menor que -1.

Ejemplos

Esta sección contiene dos ejemplos de código. En el primer ejemplo de código se muestra cómo usar la MaxDataBindDepth propiedad para enlazar solo los dos primeros niveles de nodo (profundidades 0 y 1) al TreeView control . El segundo ejemplo de código proporciona datos XML de ejemplo para el primer ejemplo de código.

En el ejemplo de código siguiente se muestra cómo usar la MaxDataBindDepth propiedad para enlazar solo los dos primeros niveles de nodo (profundidades 0 y 1) al TreeView control . Se omiten todos los niveles de nodo del origen de datos. Para que este ejemplo funcione correctamente, debe copiar los datos XML de ejemplo, proporcionados después de este ejemplo de código, en un archivo denominado 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>

En el ejemplo de código siguiente se proporcionan datos XML de ejemplo para el ejemplo 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>

Comentarios

Al enlazar el TreeView control a un origen de datos, use la MaxDataBindDepth propiedad para limitar el número de niveles de árbol que se van a enlazar al control. Por ejemplo, al establecer esta propiedad en 2 , solo se enlaza el nodo raíz y los nodos que están inmediatamente bajo el nodo raíz al TreeView control . Se omiten todos los nodos restantes del origen de datos.

Importante

Un usuario malintencionado puede crear una solicitud de devolución de llamada y obtener datos para los nodos del control que el desarrollador de TreeView páginas no muestra. Por lo tanto, el origen de datos debe implementar la seguridad de los datos. No utilice la MaxDataBindDepth propiedad para ocultar los datos.

El valor de esta propiedad se almacena en estado de vista.

Se aplica a

Consulte también