TreeNodeBinding.ShowCheckBox Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit une valeur indiquant si une case à cocher est affichée à côté d'un nœud auquel l'objet TreeNodeBinding est appliqué.
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)Valeur de propriété
true pour afficher une case à cocher à côté d'un nœud auquel l'objet TreeNodeBinding est appliqué ; sinon, false. La valeur par défaut est false.
Exemples
Cette section contient deux exemples de code. Le premier exemple de code montre comment utiliser la ShowCheckBox propriété pour spécifier si une case à cocher est affichée pour un nœud. Le deuxième exemple de code fournit des exemples de données XML pour le premier exemple de code.
L’exemple suivant montre comment utiliser la ShowCheckBox propriété pour spécifier si une case à cocher est affichée pour un nœud. Pour que cet exemple fonctionne correctement, vous devez copier les exemples de données XML fournies après cet exemple de code dans un fichier nommé 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>
L’exemple de code suivant fournit des exemples de données XML pour l’exemple de code précédent.
<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>
Remarques
Pour fournir une prise en charge de la sélection multinode dans le TreeView contrôle, vous pouvez afficher des cases à cocher en regard d’une image dans le nœud. Lorsque le TreeView contrôle est lié à une source de données, utilisez la ShowCheckBox propriété pour spécifier la valeur à lier à la ShowCheckBox propriété d’un TreeNode objet. Cette relation de liaison affecte tous les TreeNode objets auxquels l’objet TreeNodeBinding est appliqué. La ShowCheckBox propriété est utilisée pour afficher ou masquer la case à cocher d’un nœud.
Notes
Bien que la ShowCheckBox propriété puisse être utilisée pour afficher des cases à cocher, il est plus courant d’utiliser la ShowCheckBoxes propriété du TreeView contrôle. Toutefois, la ShowCheckBoxes propriété affecte chaque type de nœud spécifié par la propriété ; par conséquent, la ShowCheckBox propriété est souvent utilisée pour remplacer ce paramètre pour un nœud auquel l’objet TreeNodeBinding est appliqué. Vous pouvez remplacer de manière sélective la ShowCheckBox propriété en définissant directement la ShowCheckBox propriété de chaque nœud.
La valeur de cette propriété est stockée dans l’état d’affichage.
