TreeNodeBinding.DataMember 属性
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
获取或设置与数据项的 Type 属性进行匹配以确定是否应用树节点绑定的值。
public:
property System::String ^ DataMember { System::String ^ get(); void set(System::String ^ value); };public string DataMember { get; set; }member this.DataMember : string with get, setPublic Property DataMember As String属性值
与数据项的 Type 属性进行匹配以确定是否应用树节点绑定的值。 默认值为空字符串 ("")，表示尚未设置 DataMember 属性。
示例
本部分包含两个代码示例。 第一个代码示例演示如何使用 DataMember 属性指定要绑定到节点的 XML 元素。 第二个代码示例为第一个代码示例提供示例 XML 数据。
下面的代码示例演示如何使用 DataMember 属性指定要绑定到节点的 XML 元素。 若要使此代码示例正常工作，必须将示例 XML 数据（在此代码示例之后提供）复制到名为Book.xml的文件。
<%@ 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>TreeViewBinding DataMember and Depth Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TreeViewBinding DataMember and Depth Example</h3>
<!-- Set the DataMember and Depth properties of a -->
<!-- TreeNodeBinding object declaratively. You -->
<!-- can render items at the same node level -->
<!-- by setting each item's Depth property to -->
<!-- the same value. -->
<asp:TreeView id="BookTreeView"
DataSourceID="BookXmlDataSource"
runat="server">
<DataBindings>
<asp:TreeNodeBinding DataMember="Book" Depth="0" TextField="Title"/>
<asp:TreeNodeBinding DataMember="Chapter" Depth="1" TextField="Heading"/>
<asp:TreeNodeBinding DataMember="Appendix" Depth="1" TextField="Heading"/>
</DataBindings>
</asp:TreeView>
<asp:XmlDataSource id="BookXmlDataSource"
DataFile="Book.xml"
runat="server">
</asp:XmlDataSource>
</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>TreeViewBinding DataMember and Depth Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TreeViewBinding DataMember and Depth Example</h3>
<!-- Set the DataMember and Depth properties of a -->
<!-- TreeNodeBinding object declaratively. You -->
<!-- can render items at the same node level -->
<!-- by setting each item's Depth property to -->
<!-- the same value. -->
<asp:TreeView id="BookTreeView"
DataSourceID="BookXmlDataSource"
runat="server">
<DataBindings>
<asp:TreeNodeBinding DataMember="Book" Depth="0" TextField="Title"/>
<asp:TreeNodeBinding DataMember="Chapter" Depth="1" TextField="Heading"/>
<asp:TreeNodeBinding DataMember="Appendix" Depth="1" TextField="Heading"/>
</DataBindings>
</asp:TreeView>
<asp:XmlDataSource id="BookXmlDataSource"
DataFile="Book.xml"
runat="server">
</asp:XmlDataSource>
</form>
</body>
</html>
下面的代码示例为前面的代码示例提供示例 XML 数据。
<Book Title="Book Title">
<Chapter Heading="Chapter 1">
<Section Heading="Section 1">
</Section>
<Section Heading="Section 2">
</Section>
</Chapter>
<Chapter Heading="Chapter 2">
<Section Heading="Section 1">
</Section>
</Chapter>
<Appendix Heading="Appendix A">
</Appendix>
</Book>
注解
数据成员指定基础数据源中的数据项的类型，但可以根据数据源表示不同的信息。 层次结构数据源中的每个数据项 (由 System.Web.UI.IHierarchyData 对象表示) 公开一个 IHierarchyData.Type 属性，该属性指定数据项的类型。 例如，XML 元素的数据成员指定元素的名称。 当数据源包含多个数据类型时，数据成员指定要使用的数据项类型。 以下 TreeNodeBinding 声明将 <Book> 控件的 XmlDataSource 元素绑定到树中的所有节点，而不考虑层次结构中的位置：
<asp:TreeNodeBinding DataMember="Book" TextField="Title" ValueField= "ISBN">
创建 TreeNodeBinding 对象时，必须指定绑定的条件。 条件指示数据项何时应绑定到节点。 可以指定 Depth 或 DataMember 属性或两个属性。 通过同时指定两者，性能略有提升。
建立绑定条件后，可以绑定可绑定到值的对象的属性 TreeNode 。 可以绑定到数据项的字段或静态值。 绑定到静态值时，应用该对象的所有 TreeNode 对象 TreeNodeBinding 共享相同的值。
此属性的值存储在视图状态中。