通过

TreeView.AutoGenerateDataBindings 属性

  • 参考

定义

命名空间:
System.Web.UI.WebControls
程序集:
System.Web.dll

获取或设置一个值，该值指示 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 控件使用这些值，而不是自动生成的树节点绑定。

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

适用于

另请参阅