TreeNodeBinding.DataMember プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

TreeNodeBinding.DataMember プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

ツリーノードバインディングを適用するかどうかを判断するために、データ項目の IHierarchyData.Type プロパティと照合する値を取得または設定します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Property DataMember As
 String

Visual Basic (使用法)

Dim instance As TreeNodeBinding
Dim value As String

value = instance.DataMember

instance.DataMember = value

public string DataMember { get;
 set; }

C++

public:
property String^ DataMember {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_DataMember ()

/** @property */
public void set_DataMember (String value)

JScript

public function get DataMember
 () : String

public function set DataMember
 (value : String)

プロパティ値
ツリーノードバインディングを適用するかどうかを判断するために、データ項目の IHierarchyData.Type プロパティと照合する値。既定値は空の文字列 ("") です。DataMember プロパティが設定されていないことを示します。

解説

データメンバは、基になるデータソースのデータ項目の型を指定します。ただし、データソースによっては異なる情報を表している場合があります。階層データソースの各データ項目 (System.Web.UI.IHierarchyData オブジェクトで表される) は、データ項目の型を指定する IHierarchyData.Type プロパティを公開します。たとえば、XML 要素のデータメンバは、要素名を指定します。データソースに複数のデータ項目の型がある場合、使用するデータ項目の型をデータメンバが指定します。次の TreeNodeBinding 宣言は、階層構造の場所に無関係に、XmlDataSource コントロールの <Book> 要素をツリー内のすべてのノードにバインドします。

<asp:TreeNodeBinding DataMember="Book" TextField="Title" ValueField= "ISBN">

TreeNodeBinding オブジェクトを作成する場合、バインディング基準を指定する必要があります。基準は、データ項目をノードにバインドするタイミングを示します。Depth プロパティと DataMember プロパティのいずれか、または両方を指定できます。両方のプロパティを指定すると、効率が少し向上します。

バインディング基準が確立されたら、バインド可能な TreeNode オブジェクトのプロパティを値にバインドできます。データ項目のフィールドまたは静的な値にバインドできます。TreeNodeBinding オブジェクトに静的な値がバインドされた場合、そのオブジェクトの適用先となるすべての TreeNode オブジェクトは、同じ値を共有します。

このプロパティの値はビューステートに格納されます。

使用例

このセクションには、2 つのコード例が含まれています。DataMember プロパティを使用して、ノードにバインドする XML 要素を指定する方法を最初のコード例に示します。最初のコード例に対応したサンプル XML データを 2 番目のコード例に示します。

DataMember プロパティを使用して、ノードにバインドする XML 要素を指定する方法を次のコード例に示します。このコード例を正常に動作させるには、このコード例の後に示すサンプル XML データを、Book.xml という名前のファイルにコピーする必要があります。

Visual Basic

<%@ Page Language="VB" %>

<html>
  <body>
    <form 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="C#" %>

<html>
  <body>
    <form 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>