次の方法で共有


TreeView.AutoGenerateDataBindings プロパティ

定義

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

public:
 property bool AutoGenerateDataBindings { bool get(); void set(bool value); };
public bool AutoGenerateDataBindings { get; set; }
member this.AutoGenerateDataBindings : bool with get, set
Public Property AutoGenerateDataBindings As Boolean

プロパティ値

Boolean

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

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

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


<%@ 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 AutoGenerateBindings Example</title>
</head>
<body>
    <form id="form1" 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="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 AutoGenerateBindings Example</title>
</head>
<body>
    <form id="form1" 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>

注釈

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

注意

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

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

注意

コレクションを DataBindings 定義する場合、コントロールでは TreeView 、自動的に生成されるツリー ノード バインドではなく、これらの値が使用されます。

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

適用対象

こちらもご覧ください