TreeView.MaxDataBindDepth TreeView.MaxDataBindDepth TreeView.MaxDataBindDepth TreeView.MaxDataBindDepth Property

Definizione

Ottiene o imposta il numero massimo di livelli della struttura ad albero da associare al controllo TreeView.Gets or sets the maximum number of tree levels to bind to the TreeView control.

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

Valore della proprietà

Numero massimo di livelli della struttura ad albero da associare al controllo TreeView.The maximum number of tree levels to bind to the TreeView control. Il valore predefinito è -1 e associa al controllo tutti i livelli della struttura ad albero nell'origine dati.The default is -1, which binds all the tree levels in the data source to the control.

Eccezioni

Il valore selezionato è minore di -1.The selected value is less than -1.

Esempi

In questa sezione sono riportati due esempi di codice.This section contains two code examples. Nel primo esempio di codice viene illustrato come utilizzare MaxDataBindDepth la proprietà per associare al TreeView controllo solo i primi due livelli di nodo (profondità 0 e 1).The first code example demonstrates how to use the MaxDataBindDepth property to bind only the first two node levels (depths 0 and 1) to the TreeView control. Il secondo esempio di codice fornisce dati XML di esempio per il primo esempio di codice.The second code example provides sample XML data for the first code example.

Nell'esempio di codice riportato di seguito viene illustrato MaxDataBindDepth come utilizzare la proprietà per associare al TreeView controllo solo i primi due livelli di nodo (profondità 0 e 1).The following code example demonstrates how to use the MaxDataBindDepth property to bind only the first two node levels (depths 0 and 1) to the TreeView control. Tutti i livelli di nodo nell'origine dati vengono ignorati.All node levels in the data source are ignored. Per il corretto funzionamento di questo esempio, è necessario copiare i dati XML di esempio, forniti dopo questo esempio di codice, in un file denominato book. XML.For this example to work correctly, you must copy the sample XML data, provided after this code example, to a file named 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>

Nell'esempio di codice riportato di seguito vengono forniti dati XML di esempio per l'esempio di codice precedente.The following code example provides sample XML data for the preceding code example.

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

Commenti

Quando si associa TreeView il controllo a un'origine dati, utilizzare MaxDataBindDepth la proprietà per limitare il numero di livelli della struttura ad albero da associare al controllo.When binding the TreeView control to a data source, use the MaxDataBindDepth property to limit the number of tree levels to bind to the control. Se ad esempio si imposta questa proprietà 2 su, solo il nodo radice e i nodi immediatamente sotto il nodo TreeView radice vengono associati al controllo.For example, setting this property to 2 binds only the root node and any nodes that are immediately under the root node to the TreeView control. Tutti i nodi rimanenti nell'origine dati vengono ignorati.All remaining nodes in the data source are ignored.

Importante

Un utente malintenzionato può creare una richiesta di callback e ottenere i dati per TreeView i nodi del controllo che lo sviluppatore della pagina non sta visualizzando.A malicious user can create a callback request and get data for the nodes of the TreeView control that the page developer is not displaying. Pertanto, la sicurezza dei dati deve essere implementata dall'origine dati.Therefore, security of the data must be implemented by the data source. Non usare la MaxDataBindDepth proprietà per nascondere i dati.Do not use the MaxDataBindDepth property to hide data.

Il valore di questa proprietà viene archiviato nello stato di visualizzazione.The value of this property is stored in view state.

Si applica a

Vedi anche