TreeNodeBinding.ShowCheckBox Tulajdonság
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Beolvas vagy beállít egy értéket, amely jelzi, hogy egy jelölőnégyzet jelenik-e meg az objektumot alkalmazó csomópont TreeNodeBinding mellett.
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)Tulajdonság értéke
true egy olyan csomópont melletti jelölőnégyzet megjelenítéséhez, amelyre az TreeNodeBinding objektumot alkalmazza; ellenkező esetben false. Az alapértelmezett érték a false.
Példák
Ez a szakasz két példakódot tartalmaz. Az első példakód bemutatja, hogyan használhatja a ShowCheckBox tulajdonságot annak megadására, hogy megjelenik-e egy csomópont jelölőnégyzete. A második példa xml-mintaadatokat biztosít az első kód példájához.
Az alábbi példa bemutatja, hogyan használható a ShowCheckBox tulajdonság annak megadására, hogy megjelenik-e egy csomópont jelölőnégyzete. Ahhoz, hogy ez a példa megfelelően működjön, a példakód után megadott XML-mintaadatokat egy Book.xmlnevű fájlba kell másolnia.
<%@ 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>
Az alábbi példakód az előző kódmintához tartozó XML-mintaadatokat tartalmazza.
<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>
Megjegyzések
Ha többcsomópontos kijelölési támogatást szeretne biztosítani a TreeView vezérlőben, a csomóponton lévő kép mellett jelölőnégyzeteket jeleníthet meg. Ha a TreeView vezérlő egy adatforráshoz van kötve, a ShowCheckBox tulajdonság használatával adja meg az objektum tulajdonságához ShowCheckBoxTreeNode kötéshez szükséges értéket. Ez a kötési kapcsolat minden TreeNode olyan objektumra hatással van, amelyre az TreeNodeBinding objektumot alkalmazza. A ShowCheckBox tulajdonság egy csomópont jelölőnégyzetének megjelenítésére vagy elrejtésére szolgál.
Note
Bár a ShowCheckBox tulajdonság használható jelölőnégyzetek megjelenítésére, gyakoribb a vezérlőelem tulajdonságának ShowCheckBoxes használataTreeView. A ShowCheckBoxes tulajdonság azonban minden, a tulajdonság által megadott csomóponttípusra hatással van, ezért a ShowCheckBox tulajdonságot gyakran használják egy olyan csomópont beállításának felülbírálására, amelyre az TreeNodeBinding objektumot alkalmazza. Az egyes csomópontok tulajdonságának közvetlen beállításával szelektíven felülbírálhatja ShowCheckBox a ShowCheckBox tulajdonságot.
Ennek a tulajdonságnak az értéke megtekintési állapotban van tárolva.
