다음을 통해 공유

TreeNodeBinding.Depth 속성

정의

네임스페이스:
System.Web.UI.WebControls
어셈블리:
System.Web.dll

개체가 적용되는 노드 깊이를 TreeNodeBinding 가져오거나 설정합니다.

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

속성 값

Int32

개체가 적용되는 노드 깊이 TreeNodeBinding 입니다. 기본값은 -1로, 속성이 Depth 설정되지 않았음을 나타냅니다.

특성
TypeConverterAttribute

예제

이 섹션에는 두 가지 코드 예제가 포함되어 있습니다. 첫 번째 코드 예제에서는 속성을 사용 하 여 Depth 특정 노드 깊이에서 개체를 TreeNodeBinding 적용 하는 방법을 보여 줍니다. 두 번째 코드 예제에서는 첫 번째 코드 예제에 대한 샘플 XML 데이터를 제공합니다.

다음 코드 예제에서는 속성을 사용 하 여 Depth 특정 노드 깊이에서 개체를 TreeNodeBinding 적용 하는 방법을 보여 줍니다. 이 예제가 제대로 작동하려면 이 코드 예제 다음에 제공된 샘플 XML 데이터를 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>

다음 코드 예제에서는 앞의 코드 예제에 대한 샘플 XML 데이터를 제공합니다.

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

설명

노드 깊이는 바인딩되는 노드 수준을 지정합니다. 예를 들어 다음 선언은 TreeNodeBinding 깊이가 0인 모든 노드의 데이터 원본 Text 및 필드를 각각 및 Value 속성에 바인딩 NameID 합니다.

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

개체를 TreeNodeBinding 만들 때 바인딩 조건을 지정해야 합니다. 조건은 데이터 항목을 노드에 바인딩해야 하는 시기를 나타냅니다. 또는 속성 또는 DataMember 두 속성을 모두 지정할 Depth 수 있습니다. 둘 다 지정하면 약간의 성능 향상이 있습니다.

바인딩 조건이 설정되면 값에 바인딩할 수 있는 TreeNode 개체의 속성을 바인딩할 수 있습니다. 데이터 항목의 필드 또는 정적 값에 바인딩할 수 있습니다. 정적 값에 바인딩된 경우 개체가 TreeNodeBinding 적용되는 모든 TreeNode 개체는 동일한 값을 공유합니다.

이 속성의 값은 뷰 상태에 저장됩니다.

적용 대상

추가 정보