Condividi tramite

TreeView.MaxDataBindDepth Proprietà

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ottiene o imposta il numero massimo di livelli di albero da associare al TreeView controllo.

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à

Int32

Numero massimo di livelli di albero da associare al TreeView controllo. Il valore predefinito è -1, che associa tutti i livelli dell'albero nell'origine dati al controllo.

Eccezioni

ArgumentOutOfRangeException

Il valore selezionato è minore di -1.

Esempio

Questa sezione contiene due esempi di codice. Il primo esempio di codice illustra come usare la MaxDataBindDepth proprietà per associare solo i primi due livelli di nodo (profondità 0 e 1) al TreeView controllo. Il secondo esempio di codice fornisce dati XML di esempio per il primo esempio di codice.

Nell'esempio di codice seguente viene illustrato come usare la MaxDataBindDepth proprietà per associare al controllo solo i primi due livelli di nodo (profondità 0 e 1).TreeView Tutti i livelli di nodo nell'origine dati vengono ignorati. Affinché questo esempio funzioni correttamente, è necessario copiare i dati XML di esempio, forniti dopo questo esempio di codice, in un file denominato 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 seguente vengono forniti dati XML di esempio per l'esempio di codice precedente.

<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 il controllo a un'origine TreeView dati, utilizzare la MaxDataBindDepth proprietà per limitare il numero di livelli di albero da associare al controllo. Ad esempio, impostando questa proprietà per 2 associare solo il nodo radice e tutti i nodi immediatamente sotto il nodo radice al TreeView controllo. Tutti i nodi rimanenti nell'origine dati vengono ignorati.

Importante

Un utente malintenzionato può creare una richiesta di callback e ottenere dati per i nodi del TreeView controllo che lo sviluppatore della pagina non visualizza. Pertanto, la sicurezza dei dati deve essere implementata dall'origine dati. Non utilizzare la MaxDataBindDepth proprietà per nascondere i dati.

Il valore di questa proprietà viene archiviato nello stato di visualizzazione.

Si applica a

Vedi anche