TreeNodeBinding.ShowCheckBox Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta un valore che indica se una casella di controllo viene visualizzata accanto a un nodo a cui è applicato l'oggetto 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, setPublic Property ShowCheckBox As Nullable(Of Boolean)Valore della proprietà
true per visualizzare una casella di controllo accanto a un nodo a cui è applicato l'oggetto TreeNodeBinding; in caso contrario, false. Il valore predefinito è false.
Esempio
In questa sezione sono riportati due esempi di codice. Nel primo esempio di codice viene illustrato come utilizzare la ShowCheckBox proprietà per specificare se viene visualizzata una casella di controllo per un nodo. Nel secondo esempio di codice vengono forniti dati XML di esempio per il primo esempio di codice.
Nell'esempio seguente viene illustrato come utilizzare la ShowCheckBox proprietà per specificare se viene visualizzata una casella di controllo per un nodo. Per il corretto funzionamento di questo esempio, è necessario copiare i dati XML di esempio, forniti dopo questo esempio di codice, in un file denominato 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>
Nell'esempio di codice seguente vengono forniti dati XML di esempio per l'esempio di codice precedente.
<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>
Commenti
Per fornire supporto per la selezione multinodo nel TreeView controllo, è possibile visualizzare le caselle di controllo accanto a un'immagine nel nodo. Quando il TreeView controllo è associato a un'origine dati, utilizzare la ShowCheckBox proprietà per specificare il valore da associare alla ShowCheckBox proprietà di un TreeNode oggetto . Questa relazione di associazione influisce su tutti gli TreeNode oggetti a cui viene applicato l'oggetto TreeNodeBinding . La ShowCheckBox proprietà viene utilizzata per visualizzare o nascondere la casella di controllo per un nodo.
Nota
Anche se la ShowCheckBox proprietà può essere utilizzata per visualizzare le caselle di controllo, è più comune usare la ShowCheckBoxes proprietà del TreeView controllo . Tuttavia, la ShowCheckBoxes proprietà influisce su ogni tipo di nodo specificato dalla proprietà, pertanto la ShowCheckBox proprietà viene spesso utilizzata per eseguire l'override di tale impostazione per un nodo a cui viene applicato l'oggetto TreeNodeBinding . È possibile eseguire l'override selettiva della ShowCheckBox proprietà impostando direttamente la ShowCheckBox proprietà di ogni nodo.
Il valore di questa proprietà viene archiviato nello stato di visualizzazione.
