TreeView.MaxDataBindDepth Propriété

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient ou définit le nombre maximal de niveaux d'arborescence à lier au contrôle 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

Valeur de propriété

Int32

Nombre maximal de niveaux d'arborescence à lier au contrôle TreeView. La valeur par défaut est -1, ce qui permet de lier tous les niveaux d'arborescence de la source de données au contrôle.

Exceptions

ArgumentOutOfRangeException

La valeur sélectionnée est inférieure à -1.

Exemples

Cette section contient deux exemples de code. Le premier exemple de code montre comment utiliser la MaxDataBindDepth propriété pour lier uniquement les deux premiers niveaux de nœud (profondeurs 0 et 1) au TreeView contrôle. Le deuxième exemple de code fournit des exemples de données XML pour le premier exemple de code.

L’exemple de code suivant montre comment utiliser la MaxDataBindDepth propriété pour lier uniquement les deux premiers niveaux de nœud (profondeurs 0 et 1) au TreeView contrôle. Tous les niveaux de nœud de la source de données sont ignorés. Pour que cet exemple fonctionne correctement, vous devez copier l’exemple de données XML, fourni après cet exemple de code, dans un fichier nommé 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>

L’exemple de code suivant fournit des exemples de données XML pour l’exemple de code précédent.

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

Remarques

Lors de la liaison du contrôle à une source de données, utilisez la TreeView MaxDataBindDepth propriété pour limiter le nombre de niveaux d’arborescence à lier au contrôle. Par exemple, définissez cette propriété pour 2 lier uniquement le nœud racine et tous les nœuds qui se trouvent immédiatement sous le nœud racine au TreeView contrôle. Tous les nœuds restants de la source de données sont ignorés.

Important

Un utilisateur malveillant peut créer une demande de rappel et obtenir des données pour les nœuds du contrôle que le développeur de TreeView page n’affiche pas. Par conséquent, la sécurité des données doit être implémentée par la source de données. N’utilisez pas la MaxDataBindDepth propriété pour masquer les données.

La valeur de cette propriété est stockée dans l’état d’affichage.

S’applique à

Voir aussi

ExpandDepth