TreeView.MaxDataBindDepth Proprietà

  • Riferimento

Definizione

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

Ottiene o imposta il numero massimo di livelli della struttura ad albero da associare al controllo 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

Valore della proprietà

Int32

Numero massimo di livelli della struttura ad albero da associare al controllo TreeView. Il valore predefinito è -1 e associa al controllo tutti i livelli della struttura ad albero nell'origine dati.

Eccezioni

ArgumentOutOfRangeException

Il valore selezionato è minore di -1.

Esempio

In questa sezione sono riportati 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 solo i primi due livelli di nodo (profondità 0 e 1) al TreeView controllo. Tutti i livelli di nodo nell'origine dati vengono ignorati. 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.


<%@ 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 dati, usare la TreeViewMaxDataBindDepth 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 di pagina non viene visualizzato. Pertanto, la sicurezza dei dati deve essere implementata dall'origine dati. Non usare la proprietà per nascondere i MaxDataBindDepth dati.

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

Si applica a

Vedi anche