Share via

TreeNodeBinding.ShowCheckBox Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ruft einen Wert ab, der angibt, ob ein Kontrollkästchen neben einem Knoten angezeigt wird, auf den das TreeNodeBinding-Objekt angewendet wird, oder legt diesen Wert fest.

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)

Eigenschaftswert

Nullable<Boolean>

true zum Anzeigen eines Kontrollkästchens neben einem Knoten, auf den das TreeNodeBinding-Objekt angewendet wird, andernfalls false. Der Standardwert ist false.

Beispiele

Dieser Abschnitt enthält zwei Codebeispiele. Im ersten Codebeispiel wird veranschaulicht, wie die ShowCheckBox -Eigenschaft verwendet wird, um anzugeben, ob ein Kontrollkästchen für einen Knoten angezeigt wird. Das zweite Codebeispiel enthält XML-Beispieldaten für das erste Codebeispiel.

Im folgenden Beispiel wird veranschaulicht, wie die ShowCheckBox -Eigenschaft verwendet wird, um anzugeben, ob ein Kontrollkästchen für einen Knoten angezeigt wird. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie die XML-Beispieldaten, die nach diesem Codebeispiel bereitgestellt werden, in eine Datei namens Book.xml kopieren.


<%@ 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>

Das folgende Codebeispiel enthält XML-Beispieldaten für das vorangehende Codebeispiel.

<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>

Hinweise

Um unterstützung für die TreeView Auswahl mehrerer Knoten im -Steuerelement bereitzustellen, können Sie Kontrollkästchen neben einem Bild im Knoten anzeigen. Wenn das TreeView Steuerelement an eine Datenquelle gebunden ist, verwenden Sie die ShowCheckBox -Eigenschaft, um den Wert anzugeben, der an die ShowCheckBox -Eigenschaft eines TreeNode Objekts gebunden werden soll. Diese Bindungsbeziehung wirkt sich auf alle TreeNode Objekte aus, auf die das TreeNodeBinding Objekt angewendet wird. Die ShowCheckBox -Eigenschaft wird verwendet, um das Kontrollkästchen für einen Knoten ein- oder auszublenden.

Hinweis

Obwohl die ShowCheckBox -Eigenschaft zum Anzeigen von Kontrollkästchen verwendet werden kann, ist es üblicher, die ShowCheckBoxes -Eigenschaft des -Steuerelements TreeView zu verwenden. Die -Eigenschaft wirkt sich jedoch auf jeden Knotentyp aus, ShowCheckBoxes der von der -Eigenschaft angegeben wird. Daher wird die ShowCheckBox -Eigenschaft häufig verwendet, um diese Einstellung für einen Knoten zu überschreiben, auf den das TreeNodeBinding Objekt angewendet wird. Sie können die ShowCheckBox Eigenschaft selektiv überschreiben, indem Sie die ShowCheckBox Eigenschaft jedes Knotens direkt festlegen.

Der Wert dieser Eigenschaft wird im Ansichtszustand gespeichert.

Gilt für:

Weitere Informationen