TreeNodeBinding.ShowCheckBox 属性
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
获取或设置一个值，指示是否在 TreeNodeBinding 对象应用到的节点旁边显示复选框。
public:
property Nullable<bool> ShowCheckBox { Nullable<bool> get(); void set(Nullable<bool> value); };public bool? ShowCheckBox { get; set; }member this.ShowCheckBox : Nullable<bool> with get, setPublic Property ShowCheckBox As Nullable(Of Boolean)属性值
如果在 TreeNodeBinding 对象应用到的节点旁边显示复选框，则为 true，否则为 false。 默认值为 false。
示例
本部分包含两个代码示例。 第一个代码示例演示如何使用 ShowCheckBox 属性指定是否为节点显示复选框。 第二个代码示例提供第一个代码示例的示例 XML 数据。
以下示例演示如何使用 ShowCheckBox 属性指定是否为节点显示复选框。 若要使此示例正常工作，必须将此示例后提供的示例 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">
<script runat="server">
void BookTreeView_CheckChanged(Object sender, TreeNodeEventArgs e)
{
// Display the nodes that have their check box selected.
Message.Text = "You selected the following check boxes: ";
foreach(TreeNode node in BookTreeView.CheckedNodes)
{
Message.Text += node.Text + " ";
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>TreeNodeBinding ShowCheckBox Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TreeNodeBinding ShowCheckBox Example</h3>
<asp:treeview id="BookTreeView"
datasourceid="BookXmlDataSource"
expanddepth="2"
OnTreeNodeCheckChanged="BookTreeView_CheckChanged"
runat="server">
<DataBindings>
<asp:TreeNodeBinding DataMember="Book"
TextField="Title"/>
<asp:TreeNodeBinding DataMember="Chapter"
TextField="Heading"
ShowCheckBox="True"/>
</DataBindings>
</asp:treeview>
<asp:xmldatasource id="BookXmlDataSource"
datafile="Book.xml"
runat="server">
</asp:xmldatasource>
<br/><br/>
<asp:label id="Message"
runat="server"/>
<hr/>
<asp:button id="SubmitButton"
Text="Submit"
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">
<script runat="server">
Sub BookTreeView_CheckChanged(sender As Object, e As TreeNodeEventArgs)
' Display the nodes that have their check box selected.
Message.Text = "You selected the following check boxes: "
Dim node As TreeNode
For Each node in BookTreeView.CheckedNodes
Message.Text &= node.Text & " "
Next
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>TreeNodeBinding ShowCheckBox Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TreeNodeBinding ShowCheckBox Example</h3>
<asp:treeview id="BookTreeView"
datasourceid="BookXmlDataSource"
expanddepth="2"
OnTreeNodeCheckChanged="BookTreeView_CheckChanged"
runat="server">
<DataBindings>
<asp:TreeNodeBinding DataMember="Book"
TextField="Title"/>
<asp:TreeNodeBinding DataMember="Chapter"
TextField="Heading"
ShowCheckBox="True"/>
</DataBindings>
</asp:treeview>
<asp:xmldatasource id="BookXmlDataSource"
datafile="Book.xml"
runat="server">
</asp:xmldatasource>
<br/><br/>
<asp:label id="Message"
runat="server"/>
<hr/>
<asp:button id="SubmitButton"
text="Submit"
runat="server"/>
</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>
注解
若要在 控件中 TreeView 提供多节点选择支持，可以在节点中的图像旁边显示复选框。 当 TreeView 控件绑定到数据源时，使用 ShowCheckBox 属性指定要绑定到 ShowCheckBox 对象的 属性 TreeNode 的值。 此绑定关系会影响应用该TreeNodeBinding对象的所有TreeNode对象。 属性 ShowCheckBox 用于显示或隐藏节点的复选框。
注意
ShowCheckBox虽然 属性可用于显示复选框，但更常见的是使用 ShowCheckBoxes 控件的 TreeView 属性。 但是， ShowCheckBoxes 属性会影响由 属性指定的每个节点类型;因此， ShowCheckBox 属性通常用于替代对象所应用到的节点的 TreeNodeBinding 该设置。 可以通过直接设置ShowCheckBox每个节点的 属性来有选择地替代 ShowCheckBox 属性。
此属性的值存储在视图状态中。
