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

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

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

TreeView.AutoGenerateDataBindings プロパティ

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

TreeView コントロールがツリーノードのバインディングを自動的に生成するかどうかを示す値を取得または設定します。

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

Visual Basic (宣言)

Public Property AutoGenerateDataBindings As
 Boolean

Visual Basic (使用法)

Dim instance As TreeView
Dim value As Boolean

value = instance.AutoGenerateDataBindings

instance.AutoGenerateDataBindings = value

public bool AutoGenerateDataBindings { get;
 set; }

C++

public:
property bool AutoGenerateDataBindings {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_AutoGenerateDataBindings ()

/** @property */
public void set_AutoGenerateDataBindings (boolean
 value)

JScript

public function get AutoGenerateDataBindings
 () : boolean

public function set AutoGenerateDataBindings
 (value : boolean)

プロパティ値
TreeView コントロールによりツリーノードのバインディングが自動的に生成される場合は true。それ以外の場合は false。既定値は true です。

解説

ツリーノードのバインディングは、データ項目とそのバインド先のノードとの関係を定義します。複数の属性を持つ XML 要素などのように、各データ項目に複数のプロパティが含まれているデータソースにバインドする場合、TreeView コントロールは、どの TreeNode プロパティにどのデータ項目のプロパティをバインドするかを認識する必要があります。AutoGenerateDataBindings プロパティが true に設定されている場合、TreeView コントロールは既定のツリーノードのバインディングを自動的に生成します。このバインディングは、データ項目の ToString メソッドによって返される値へのバインディングに関連付けられた TreeNode オブジェクトの Text プロパティを設定します。

メモ
自動的に生成されたツリーノードのバインディングは、DataBindings コレクションには追加されません。

XML 要素の場合、ToString メソッドによって返される値は要素名です。この要素名は、XML ファイルの基になる構造体を示す以外はあまり用途はありません。より便利なツリーを作成するには、DataBindings コレクションにデータを設定して、独自のツリーノードのバインディングを定義する必要があります。

メモ
DataBindings コレクションを定義すると、TreeView コントロールは、自動的に生成されたツリーノードのバインディングではなく、定義された値を使用します。

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

使用例

このセクションには、2 つのコード例が含まれています。AutoGenerateDataBindings プロパティを false に設定して、ツリーノードのバインディングの自動生成を無効にする方法を最初のコード例に示します。最初のコード例に対応したサンプルサイトマップデータを 2 番目のコード例に示します。

AutoGenerateDataBindings プロパティを false に設定して、ツリーノードのバインディングの自動生成を無効にする方法を次のコード例に示します。DataBindings コレクションが定義され、SiteMapDataSource コントロール内のデータ項目と TreeView コントロールのノードの間に関係が確立されます。この例を正常に動作させるには、このコード例の後に示すサンプルサイトマップデータを、Web.sitemap という名前のファイルにコピーする必要があります。

Visual Basic

<%@ Page Language="VB" %>

<html>
  <body>
    <form runat="server">
    
      <h3>TreeView AutoGenerateBindings Example</h3>
    
      <!-- Set the AutoGenerateBindings property
 -->
      <!-- to false declaratively to
 allow for   -->
      <!-- the user-defined Bindings collection. -->
      <asp:TreeView id="SiteTreeView" 
        DataSourceID="SiteMapSource"
        AutoGenerateDataBindings="False"
        runat="server">
        
        <DataBindings>
        
          <asp:TreeNodeBinding TextField="title"
 NavigateUrlField="url"/>
        
        </DataBindings>
            
      </asp:TreeView>
      
      <asp:SiteMapDataSource ID="SiteMapSource"
 runat="server"/>
         
    </form>
  </body>
</html>

<%@ Page Language="C#" %>

<html>
  <body>
    <form runat="server">
    
      <h3>TreeView AutoGenerateBindings Example</h3>
    
      <!-- Set the AutoGenerateBindings property -->
      <!-- to false declaratively to allow for
   -->
      <!-- the user-defined Bindings collection. -->
      <asp:TreeView id="SiteTreeView" 
        DataSourceID="SiteMapSource"
        AutoGenerateDataBindings="False"
        runat="server">
        
        <DataBindings>
        
          <asp:TreeNodeBinding TextField="title" NavigateUrlField="url"/>
        
        </DataBindings>
            
      </asp:TreeView>
      
      <asp:SiteMapDataSource ID="SiteMapSource" runat="server"/>
         
    </form>
  </body>
</html>

前の例に対応したサンプルサイトマップデータを次のコード例に示します。

<siteMap>
    <siteMapNode title="Home" description="Home" url="default.aspx">
        <siteMapNode title="Products" description="Products" url="Products.aspx">
            <siteMapNode title="Computers" url="Computers.aspx"/>
            <siteMapNode title="Accessories" url="Accessories.aspx"/>     
        </siteMapNode>
    </siteMapNode>
</siteMap>