TreeNodeBinding.ShowCheckBox Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of er een selectievakje wordt weergegeven naast een knooppunt waarop het TreeNodeBinding object wordt toegepast.
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)Waarde van eigenschap
true om een selectievakje weer te geven naast een knooppunt waarop het TreeNodeBinding object wordt toegepast; falseanders. De standaardwaarde is false.
Voorbeelden
Deze sectie bevat twee codevoorbeelden. In het eerste codevoorbeeld ziet u hoe u de ShowCheckBox eigenschap gebruikt om op te geven of er een selectievakje voor een knooppunt wordt weergegeven. Het tweede codevoorbeeld bevat voorbeeld-XML-gegevens voor het eerste codevoorbeeld.
In het volgende voorbeeld ziet u hoe u de ShowCheckBox eigenschap gebruikt om op te geven of een selectievakje wordt weergegeven voor een knooppunt. Als dit voorbeeld correct werkt, moet u de voorbeeld-XML-gegevens kopiëren, die na dit codevoorbeeld zijn opgegeven, naar een bestand met de naam 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>
Het volgende codevoorbeeld bevat voorbeeld-XML-gegevens voor het voorgaande codevoorbeeld.
<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>
Opmerkingen
Als u ondersteuning voor meerdere knooppuntselecties in het TreeView besturingselement wilt bieden, kunt u selectievakjes naast een afbeelding in het knooppunt weergeven. Wanneer het TreeView besturingselement is gebonden aan een gegevensbron, gebruikt u de ShowCheckBox eigenschap om de waarde op te geven die moet worden gekoppeld aan de ShowCheckBox eigenschap van een TreeNode object. Deze bindingsrelatie is van invloed op alle TreeNode objecten waarop het TreeNodeBinding object wordt toegepast. De ShowCheckBox eigenschap wordt gebruikt om het selectievakje voor een knooppunt weer te geven of te verbergen.
Note
Hoewel de ShowCheckBox eigenschap kan worden gebruikt om selectievakjes weer te geven, is het gebruikelijker om de ShowCheckBoxes eigenschap van het TreeView besturingselement te gebruiken. De ShowCheckBoxes eigenschap is echter van invloed op elk knooppunttype dat is opgegeven door de eigenschap. Daarom wordt de ShowCheckBox eigenschap vaak gebruikt om die instelling te overschrijven voor een knooppunt waarop het TreeNodeBinding object wordt toegepast. U kunt de ShowCheckBox eigenschap selectief overschrijven door de ShowCheckBox eigenschap van elk knooppunt rechtstreeks in te stellen.
De waarde van deze eigenschap wordt opgeslagen in de weergavestatus.
