Exporter (0) Imprimer
Développer tout

TreeNodeBinding.Depth, propriété

Mise à jour : novembre 2007

Obtient ou définit la profondeur de nœud à laquelle l'objet TreeNodeBinding 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=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public int Depth { get; set; }
/** @property */
/** @attribute TypeConverterAttribute("System.Web.UI.Design.WebControls.TreeNodeBindingDepthConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a") */
public int get_Depth()
/** @property */
/** @attribute TypeConverterAttribute("System.Web.UI.Design.WebControls.TreeNodeBindingDepthConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a") */
public  void set_Depth(int value)

public function get Depth () : int
public function set Depth (value : int)

Valeur de propriété

Type : System.Int32

Profondeur de nœud à laquelle l'objet TreeNodeBinding est appliqué. La valeur par défaut est -1 indiquant que la propriété Depth n'est pas définie.

Une profondeur de nœud spécifie le niveau de nœud qui est lié. Par exemple, la déclaration TreeNodeBinding suivante lie les champs Name et ID de la source de données aux propriétés Text et Value, respectivement, de tous les nœuds d'une profondeur de 0 :

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

Lorsque vous créez un objet TreeNodeBinding, vous devez spécifier les critères de liaison. Les critères indiquent à quel moment un élément de données doit être lié à un nœud. Vous pouvez spécifier la propriété Depth ou DataMember ou les deux. Vous obtenez un léger gain de performance en spécifiant les deux.

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

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

Cette section comprend deux exemples de code. Le premier exemple de code montre comment utiliser la propriété Depth pour appliquer un objet TreeNodeBinding à 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 la propriété Depth pour appliquer un objet TreeNodeBinding à une profondeur de nœud spécifique. Pour que cet exemple fonctionne, 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>

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft