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

示例

本部分包含两个代码示例。 第一个代码示例演示如何通过将属性设置为AutoGenerateDataBindingsfalse禁用自动树节点绑定生成。 第二个代码示例为第一个代码示例提供示例站点地图数据。

下面的代码示例演示如何通过将属性设置为AutoGenerateDataBindingsfalse禁用自动树节点绑定生成。 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如果该属性设置为 true,控件TreeView将自动生成默认树节点绑定,该绑定将Text与绑定关联的对象属性TreeNode设置为数据项方法返回ToString的值。

备注

自动生成的树节点绑定不会添加到 DataBindings 集合中。

对于 XML 元素,该方法返回 ToString 的值是元素名称,它显示 XML 文件的基础结构,但不非常有用。 若要创建更有用的树,必须通过填充 DataBindings 集合来定义自己的树节点绑定。

备注

如果定义 DataBindings 集合,则 TreeView 控件使用这些值,而不是自动生成的树节点绑定。

此属性的值存储在视图状态中。

适用于

另请参阅