TreeNodeBinding.Depth 속성

정의

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 속성이 설정되어 있지 않음을 나타냅니다.

특성

예제

이 섹션에는 두 코드 예제가 있습니다. 첫 번째 코드 예제를 사용 하는 방법에 설명 합니다 Depth 적용할 속성을를 TreeNodeBinding 특정 노드 수준에는 개체입니다. 두 번째 코드 예제에서는 첫 번째 코드 예제에 대 한 샘플 XML 데이터를 제공합니다.

다음 코드 예제를 사용 하는 방법에 설명 합니다 Depth 적용할 속성을 TreeNodeBinding 특정 노드 수준에는 개체. 이 예제가 제대로 작동 하려면에 대 한 Book.xml 라는 파일에이 코드 예제에서는 뒤에 제공 된 샘플 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 선언 바인딩합니다 합니다 Name 하 고 ID 데이터 원본의 필드를 TextValue 속성을 각각 깊이가 0 사용 하 여 모든 노드의:

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

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

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

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

적용 대상

추가 정보