TreeNode.ShowCheckBox Propriété

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtient ou définit une valeur qui indique si une case à cocher est affichée en regard du nœud.

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)

Valeur de propriété

Nullable<Boolean>

true pour afficher la case à cocher ; sinon, false.

Exemples

L’exemple de code suivant montre comment utiliser la ShowCheckBox propriété pour afficher et masquer par programmation la case à cocher d’un nœud dans le TreeView contrôle. Pour que cet exemple fonctionne correctement, vous devez copier les exemples de données XML ci-dessous 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 Data_Bound(Object sender, TreeNodeEventArgs e)
  {

    // Determine the depth of a node as it is bound to data.
    // If the depth is 1, show a check box.
    if(e.Node.Depth == 1)
    {

      e.Node.ShowCheckBox = true;

    }
    else
    {

      e.Node.ShowCheckBox = false;

    }

  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>TreeNode ShowCheckBox Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeNode ShowCheckBox Example</h3>
    
      <asp:TreeView id="BookTreeView" 
         DataSourceID="BookXmlDataSource"
         OnTreeNodeDataBound="Data_Bound"
         ShowCheckBoxes="None"
         ExpandDepth="2"  
         runat="server">
         
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" TextField="Title"/>
          <asp:TreeNodeBinding DataMember="Chapter" TextField="Heading"/>
          <asp:TreeNodeBinding DataMember="Section" TextField="Heading"/>
        </DataBindings>
         
      </asp:TreeView>

      <asp:XmlDataSource id="BookXmlDataSource"  
         DataFile="Book.xml"
         runat="server">
      </asp:XmlDataSource>
    
    </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 Data_Bound(ByVal sender As Object, ByVal e As TreeNodeEventArgs)

    ' Determine the depth of a node as it is bound to data.
    ' If the depth is 1, show a check box.
    If e.Node.Depth = 1 Then

      e.Node.ShowCheckBox = True

    Else

      e.Node.ShowCheckBox = False

    End If

  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>TreeNode ShowCheckBox Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeNode ShowCheckBox Example</h3>
    
      <asp:TreeView id="BookTreeView" 
         DataSourceID="BookXmlDataSource"
         OnTreeNodeDataBound="Data_Bound"
         ShowCheckBoxes="None"
         ExpandDepth="2"  
         runat="server">
         
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" TextField="Title"/>
          <asp:TreeNodeBinding DataMember="Chapter" TextField="Heading"/>
          <asp:TreeNodeBinding DataMember="Section" TextField="Heading"/>
        </DataBindings>
         
      </asp:TreeView>

      <asp:XmlDataSource id="BookXmlDataSource"  
         DataFile="Book.xml"
         runat="server">
      </asp:XmlDataSource>
    
    </form>
  </body>
</html>

Le code suivant est un exemple de données XML pour l’exemple 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>  
</Book>

Remarques

Le TreeView contrôle vous permet d’afficher une case à cocher en regard de l’image d’un nœud. Utilisez la ShowCheckBox propriété pour afficher ou masquer la case à cocher du nœud actuel.

Bien que la ShowCheckBox propriété puisse être utilisée pour afficher des cases à cocher, il est plus courant d’utiliser la TreeView.ShowCheckBoxes propriété du TreeView contrôle. Toutefois, la TreeView.ShowCheckBoxes propriété affecte chaque type de nœud spécifié par la propriété . Par conséquent, la TreeNode.ShowCheckBox propriété est souvent utilisée pour remplacer ce paramètre pour un nœud individuel.

Étant donné que la TreeView.ShowCheckBoxes propriété est une propriété tri-état, l’extrait de code C# suivant provoque une erreur de compilation :

protected void TreeView1_SelectedNodeChanged(object sender, EventArgs e)  
{  
if (TreeView1.Nodes[0].Expanded)  
{  
// some work here   
}  
}

Bien que VB.Net convertit implicitement la Boolean valeur en un NullableBoolean, C# ne le fait pas. Par conséquent, il est recommandé de vérifier explicitement l’état de la propriété. Par exemple, les exemples de code suivants dans Visual Basic et C# testent explicitement la valeur de la Expanded propriété.

L’exemple de code Visual Basic suivant teste explicitement la valeur de la Expanded propriété. Cet exemple teste si la Expanded propriété est définie Truesur ; par conséquent Nothing , et False passe par l’instruction If .

If TreeView1.Nodes(0).Expanded = True Then 'some work hereEnd IF

Cet exemple de code C# teste explicitement la valeur de la Expanded propriété. Cet exemple teste si la Expanded propriété est définie Truesur ; par conséquent Null , et False passe par l’instruction If .

if( TreeView1.Nodes[0].Expanded == true ) { //some work here}

La valeur de cette propriété est stockée dans l’état d’affichage.

S’applique à

Voir aussi