TreeView.MaxDataBindDepth Propiedad

Referencia

Definición

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

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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

ExpandDepth