TreeView.DataBindings 속성

정의

데이터 항목과 데이터 항목에 바인딩된 노드 간의 관계를 정의하는 TreeNodeBinding 개체의 컬렉션을 가져옵니다.

public:
 property System::Web::UI::WebControls::TreeNodeBindingCollection ^ DataBindings { System::Web::UI::WebControls::TreeNodeBindingCollection ^ get(); };
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public System.Web.UI.WebControls.TreeNodeBindingCollection DataBindings { get; }
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.DataBindings : System.Web.UI.WebControls.TreeNodeBindingCollection
Public ReadOnly Property DataBindings As TreeNodeBindingCollection

속성 값

TreeNodeBindingCollection

데이터 항목과 데이터 항목에 바인딩된 노드 간의 관계를 나타내는 TreeNodeBindingCollection입니다.

특성

예제

이 섹션에는 두 코드 예제가 있습니다. 첫 번째 코드 예제를 사용 하는 방법에 설명 합니다 DataBindings 데이터 항목과 데이터 항목이 바인딩되는 노드 간의 관계를 정의 하는 컬렉션입니다. 두 번째 코드 예제에서는 첫 번째 코드 예제에 대 한 샘플 XML 데이터를 제공합니다.

다음 코드 예제를 사용 하는 방법에 설명 합니다 DataBindings 데이터 항목과 데이터 항목이 바인딩되는 노드 간의 관계를 정의 하는 컬렉션입니다. 이 예제가 제대로 작동 하려면에 대 한 Book.xml 라는 파일에이 코드 예제에서는 뒤에 제공 된 샘플 XML 데이터를 복사 해야 합니다. 이 예제에서는 지정 된 DataMember 바인딩의 속성입니다. 또한 지정 하 여 약간의 성능 향상을 추가할 수 있습니다는 Depth 속성입니다.


<%@ 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>TreeView XML Data Binding Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView XML Data Binding Example</h3>
    
      <asp:TreeView id="BookTreeView" 
        DataSourceID="BookXmlDataSource"
        runat="server">
         
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" TextField="Title"/>
          <asp:TreeNodeBinding DataMember="Chapter" TextField="Heading"/>
          <asp:TreeNodeBinding DataMember="Section" 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>TreeView XML Data Binding Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView XML Data Binding Example</h3>
    
      <asp:TreeView id="BookTreeView" 
        DataSourceID="BookXmlDataSource"
        runat="server">
         
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" TextField="Title"/>
          <asp:TreeNodeBinding DataMember="Chapter" TextField="Heading"/>
          <asp:TreeNodeBinding DataMember="Section" 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>
</Book>

설명

합니다 DataBindings 컬렉션에 포함 되어 TreeNodeBinding 데이터 항목과 데이터 항목이 바인딩되는 노드 간의 관계를 정의 하는 개체입니다. 노드를 각 데이터 항목 (예: 몇 가지 특성을 사용 하 여 XML 요소), 여러 속성이 들어 있는 데이터 원본에 바인딩에서 반환 되는 값을 표시 하는 경우는 ToString 메서드 기본적으로 데이터 항목의 합니다. XML 요소가 아닌 경우 노드 트리에서의 기본 구조를 보여주지만 그렇지 않은 경우에 그다지 유용 하지는 요소 이름을 표시 합니다. 트리 노드 바인딩을 지정 하 여 노드는 특정 데이터 항목 속성에 바인딩할 수 있습니다.

바인딩 및 값의 속성에 바인딩할에 대 한 조건을 지정 해야 데이터 항목과 데이터 항목 노드 간의 관계를 정의할 때는 TreeNode 개체입니다. 기준은 데이터 항목 노드에 바인딩되어야 하는 시기를 나타냅니다. 노드 깊이, 데이터 멤버, 또는 둘 다를 사용 하 여 조건은 지정할 수 있습니다. 노드 수준에 바인딩되는 노드 수준을 지정 합니다. 예를 들어, 노드의 깊이가 0 지정 하는 경우 수준 0 트리 구조의 모든 노드 트리 노드 바인딩을 사용 하 여 바인딩된 됩니다. 데이터 멤버를 데이터 원본에서 데이터 항목의 형식을 지정 하지만 데이터 원본에 따라 다른 정보를 나타낼 수 있습니다. 예를 들어, XML 요소에 대 한 데이터 멤버 요소의 이름을 지정합니다.

여러 TreeNodeBinding 서로 충돌할 수 있는 개체를 정의 하는 TreeView 컨트롤 트리 노드 바인딩을 우선 순위 순서로 적용:

  1. TreeNodeBinding 수준과 데이터 멤버를 모두 정의 하는 개체입니다.

  2. TreeNodeBinding 깊이 정의 하는 개체입니다.

  3. TreeNodeBinding 유일한 데이터 멤버를 정의 하는 개체입니다.

  4. TreeNodeBinding 깊이 아니고 데이터 멤버를 정의 하는 개체입니다.

동일한 선행 조건에 맞지 않는 바인딩이 여러 개 지정 된 경우 컬렉션의 첫 번째 바인딩이 적용 됩니다.

바인딩 기준에 설정 되 면을 바인딩할 수 있습니다의 속성을 TreeNode 값에 바인딩할 수 있는 개체입니다. 특성 또는 데이터 항목의 필드에 바인딩할 수도 있고 정적 값을 표시할 수도 있습니다. 속성 바인딩 대 한 자세한 내용은 TreeNode 값으로 개체를 참조 하십시오 TreeNodeBinding합니다.

하지만 DataBindings 선언적으로 설정할 일반적으로, 컬렉션을 프로그래밍 방식으로 채울 수 있습니다. 트리 노드 바인딩을 지정 하려면 먼저 중첩 열고 닫는 <DataBindings> 을 열고 닫는 태그 사이 TreeView 제어 합니다. 다음으로 배치 <asp:TreeNodeBinding> 요소는 태그와 닫는 사이 <DataBindings> 바인딩을 사용 하면 각 트리 노드에 대 한 태그를 지정 하려면.

데이터 바인딩을 설정 하 여 만든 경우는 AutoGenerateDataBindings 의 속성을 TreeView 컨트롤을 true, 생성 된 바인딩의 PopulateOnDemand 속성이로 설정 true. 데이터 바인딩에 선언적으로 만들어진 합니다 PopulateOnDemand 속성이 설정 false합니다. 선언적 구문을 사용 하 여 개별 데이터 바인딩의 동작을 제어할 수 있습니다.

적용 대상

추가 정보