Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

TreeNodeBinding.Depth propriété

 

Date de publication : novembre 2016

Obtient ou définit la profondeur du nœud auquel le TreeNodeBinding objet est appliqué.

Espace de noms:   System.Web.UI.WebControls
Assembly:  System.Web (dans System.Web.dll)

[TypeConverterAttribute("System.Web.UI.Design.WebControls.TreeNodeBindingDepthConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public int Depth { get; set; }

Valeur de propriété

Type: System.Int32

La profondeur du nœud auquel le TreeNodeBinding objet est appliqué. La valeur par défaut est -1, ce qui indique que le Depth propriété n’est pas définie.

Une profondeur de nœud Spécifie le niveau de nœud qui est lié. Par exemple, les éléments suivants TreeNodeBinding déclaration lie le Name et ID les champs de la source de données à le Text et Value Propriétés, respectivement, de tous les nœuds avec une profondeur de 0 :

<asp:TreeNodeBinding Depth="0" TextField="Name" ValueField="ID">

Lorsque vous créez un TreeNodeBinding de l’objet, vous devez spécifier les critères de liaison. Les critères indique quand un élément de données doit être lié à un nœud. Vous pouvez spécifier le Depth ou DataMember ou les deux propriétés. Il existe un léger gain de performance en spécifiant les deux.

Une fois les critères de liaison est établie, vous pouvez ensuite lier une propriété d’un TreeNode objet qui peut être liée à une valeur. Vous pouvez lier à un champ d’un élément de données ou à une valeur statique. Lorsqu’il est lié à une valeur statique, tous les TreeNode objets auxquels le TreeNodeBinding objet est appliqué partagent la même valeur.

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

Cette section contient deux exemples de code. Le premier exemple de code montre comment utiliser le Depth propriété à laquelle appliquer un TreeNodeBinding objet à une profondeur de nœud spécifique. Le deuxième exemple de code fournit un exemple de données XML pour le premier exemple de code.

L’exemple de code suivant montre comment utiliser le Depth propriété à laquelle appliquer un TreeNodeBinding objet à une profondeur de nœud spécifique. Pour 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>TreeViewBinding DataMember and Depth Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>TreeViewBinding DataMember and Depth Example</h3>

      <!-- Set the DataMember and Depth properties of a -->
      <!-- TreeNodeBinding object declaratively. You  -->
      <!-- can render items at the same node level    -->
      <!-- by setting each item's Depth property to   -->
      <!-- the same value.                -->
      <asp:TreeView id="BookTreeView" 
        DataSourceID="BookXmlDataSource"
        runat="server">

        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" Depth="0" TextField="Title"/>
          <asp:TreeNodeBinding DataMember="Chapter" Depth="1" TextField="Heading"/>
          <asp:TreeNodeBinding DataMember="Appendix" Depth="1" 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 un exemple 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>
    <Appendix Heading="Appendix A">
    </Appendix>
</Book>

.NET Framework
Disponible depuis 2.0
Retour au début
Afficher: