TreeNodeBinding.ShowCheckBox Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar eller anger ett värde som anger om en kryssruta visas bredvid en nod som TreeNodeBinding objektet tillämpas på.
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)
Egenskapsvärde
true för att visa en kryssruta bredvid en nod som TreeNodeBinding objektet tillämpas på, falseannars . Standardvärdet är false.
Exempel
Det här avsnittet innehåller två kodexempel. Det första kodexemplet visar hur du använder ShowCheckBox egenskapen för att ange om en kryssruta ska visas för en nod. Det andra kodexemplet innehåller XML-exempeldata för det första kodexemplet.
I följande exempel visas hur du använder ShowCheckBox egenskapen för att ange om en kryssruta ska visas för en nod. För att det här exemplet ska fungera korrekt måste du kopiera XML-exempeldata, som tillhandahålls efter det här kodexemplet, till en fil med namnet 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>
Följande kodexempel innehåller XML-exempeldata för föregående kodexempel.
<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>
Kommentarer
Om du vill ge stöd för val av flera noder i TreeView kontrollen kan du visa kryssrutor bredvid en bild i noden. När kontrollen TreeView är bunden till en datakälla använder du ShowCheckBox egenskapen för att ange värdet för att binda till ShowCheckBox egenskapen för ett TreeNode objekt. Den här bindningsrelationen TreeNode påverkar alla TreeNodeBinding objekt som objektet tillämpas på. Egenskapen ShowCheckBox används för att visa eller dölja kryssrutan för en nod.
Note
Även om egenskapen ShowCheckBox kan användas för att visa kryssrutor är det vanligare att använda ShowCheckBoxes kontrollens TreeView egenskap. Egenskapen påverkar dock ShowCheckBoxes varje nodtyp som anges av egenskapen. Därför används egenskapen ofta för att åsidosätta den ShowCheckBox inställningen för en nod som TreeNodeBinding objektet tillämpas på. Du kan selektivt åsidosätta ShowCheckBox egenskapen genom att ange egenskapen för ShowCheckBox varje nod direkt.
Värdet för den här egenskapen lagras i visningstillstånd.