TreeNodeBinding.ShowCheckBox 属性

  • 参考

定义

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

获取或设置一个值，指示是否在 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, set
Public Property ShowCheckBox As Nullable(Of Boolean)

属性值

Nullable<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 属性。

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

适用于

另请参阅