TreeNodeBinding.Depth Właściwość

Definicja

Pobiera lub ustawia głębokość węzła, do której TreeNodeBinding ma zostać zastosowany obiekt.Gets or sets the node depth at which the TreeNodeBinding object is applied.

public:
 property int Depth { int get(); void set(int value); };
[System.ComponentModel.TypeConverter("System.Web.UI.Design.WebControls.TreeNodeBindingDepthConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public int Depth { get; set; }
[System.ComponentModel.TypeConverter("System.Web.UI.Design.WebControls.TreeNodeBindingDepthConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public int Depth { get; set; }
[<System.ComponentModel.TypeConverter("System.Web.UI.Design.WebControls.TreeNodeBindingDepthConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Depth : int with get, set
[<System.ComponentModel.TypeConverter("System.Web.UI.Design.WebControls.TreeNodeBindingDepthConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Depth : int with get, set
Public Property Depth As Integer

Wartość właściwości

Int32

Głębokość węzła, do której TreeNodeBinding jest stosowany obiekt.The node depth at which the TreeNodeBinding object is applied. Wartość domyślna to-1, co oznacza, że Depth Właściwość nie jest ustawiona.The default is -1, indicating that the Depth property is not set.

Atrybuty

Przykłady

Ten rozdział zawiera dwa przykłady kodu.This section contains two code examples. Pierwszy przykład kodu demonstruje, jak użyć właściwości, Depth Aby zastosować obiekt z TreeNodeBinding określoną głębokością węzła.The first code example demonstrates how to use the Depth property to apply a TreeNodeBinding object at a specific node depth. Drugi przykład kodu zawiera przykładowe dane XML dla pierwszego przykładu kodu.The second code example provides sample XML data for the first code example.

Poniższy przykład kodu demonstruje sposób użycia Depth właściwości, aby zastosować TreeNodeBinding obiekt z określoną głębokością węzła.The following code example demonstrates how to use the Depth property to apply a TreeNodeBinding object at a specific node depth. Aby ten przykład działał prawidłowo, należy skopiować przykładowe dane XML dostarczone po tym przykładzie kodu do pliku o nazwie Book.xml.For this example to work correctly, you must copy the sample XML data, provided after this code example, to a file named 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>


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

Poniższy przykład kodu zawiera przykładowe dane XML dla poprzedniego przykładu kodu.The following code example provides sample XML data for the preceding code example.

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

Uwagi

Głębokość węzła określa poziom węzła, który jest powiązany.A node depth specifies the node level that gets bound. Na przykład następująca TreeNodeBinding Deklaracja wiąże Name i ID pola źródła danych z Text Value właściwościami i, odpowiednio dla wszystkich węzłów o głębokości 0:For example, the following TreeNodeBinding declaration binds the Name and ID fields of the data source to the Text and Value properties, respectively, of all nodes with a depth of 0:

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

Podczas tworzenia TreeNodeBinding obiektu należy określić kryteria dla powiązania.When creating a TreeNodeBinding object, you must specify the criteria for binding. Kryteria wskazują, kiedy element danych powinien być powiązany z węzłem.The criteria indicates when a data item should be bound to a node. Można określić Depth Właściwość or lub DataMember obie właściwości.You can specify the Depth or DataMember property, or both properties. Istnieje niewielki wzrost wydajności przez określenie obu tych opcji.There is a slight performance gain by specifying both.

Po ustanowieniu kryteriów wiązania można powiązać Właściwość TreeNode obiektu, który może być powiązany z wartością.Once the binding criteria is established, you can then bind a property of a TreeNode object that can be bound to a value. Można powiązać z polem elementu danych lub wartością statyczną.You can bind to a field of a data item or to a static value. W przypadku powiązania z wartością statyczną wszystkie TreeNode obiekty, do których TreeNodeBinding zastosowano obiekt, mają tę samą wartość.When bound to a static value, all TreeNode objects to which the TreeNodeBinding object is applied share the same value.

Wartość tej właściwości jest przechowywana w stanie widoku.The value of this property is stored in view state.

Dotyczy

Zobacz też