TreeView.AutoGenerateDataBindings 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取或设置一个值,该值指示 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
属性值
若要让 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 控件使用这些值,而不是自动生成的树节点绑定。
此属性的值存储在视图状态中。