TreeNodeBinding.SelectAction Propriété

  • Référence

Définition

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

Obtient ou définit le ou les événements à déclencher lorsqu'un nœud auquel l'objet TreeNodeBinding est appliqué est sélectionné.

public:
 property System::Web::UI::WebControls::TreeNodeSelectAction SelectAction { System::Web::UI::WebControls::TreeNodeSelectAction get(); void set(System::Web::UI::WebControls::TreeNodeSelectAction value); };
public System.Web.UI.WebControls.TreeNodeSelectAction SelectAction { get; set; }
member this.SelectAction : System.Web.UI.WebControls.TreeNodeSelectAction with get, set
Public Property SelectAction As TreeNodeSelectAction

Valeur de propriété

TreeNodeSelectAction

Une des valeurs de l'objet TreeNodeSelectAction. La valeur par défaut est TreeNodeSelectAction.Select.

Exemples

Cette section contient deux exemples de code. Le premier exemple de code montre comment utiliser la propriété pour spécifier l’événement SelectAction déclenché lorsqu’un utilisateur clique sur 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 SelectAction propriété pour spécifier l’événement déclenché lorsqu’un utilisateur clique sur un nœud. Pour que cet exemple fonctionne correctement, vous devez copier les exemples de données XML, fournis 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 Node_Changed(Object sender, EventArgs e)
  {

    Message.Text = BookTreeView.SelectedNode.Text + " node selected.";

  }

  void Node_Expanded(Object sender, TreeNodeEventArgs e)
  {

    Message.Text = e.Node.Text + " node expanded.";

  }

  void Node_Collapsed(Object sender, TreeNodeEventArgs e)
  {

    Message.Text = "";

  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>TreeNodeBinding SelectAction Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeNodeBinding SelectAction Example</h3>
    
      <asp:TreeView id="BookTreeView"
        Font-Names= "Arial"
        ForeColor="Blue"
        DataSourceID="BookXmlDataSource"
        EnableClientScript="false" 
        OnSelectedNodeChanged="Node_Changed"
        OnTreeNodeExpanded="Node_Expanded"
        OnTreeNodeCollapsed="Node_Collapsed"   
        runat="server">
        
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" 
            TextField="Title"
            SelectAction="Expand"/>
          <asp:TreeNodeBinding DataMember="Chapter" 
            TextField="Heading"
            SelectAction="Expand"/>
        </DataBindings>
        
      </asp:TreeView>
      
      <asp:XmlDataSource id="BookXmlDataSource"  
        DataFile="Book.xml"
        runat="server">
      </asp:XmlDataSource>
      
      <br /><br />
      
      <asp:Label id="Message" 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 Node_Changed(ByVal sender As Object, ByVal e As EventArgs)

    Message.Text = BookTreeView.SelectedNode.Text & " node selected."

  End Sub

  Sub Node_Expanded(ByVal sender As Object, ByVal e As TreeNodeEventArgs)

    Message.Text = e.Node.Text & " node expanded."

  End Sub

  Sub Node_Collapsed(ByVal sender As Object, ByVal e As TreeNodeEventArgs)

    Message.Text = ""

  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>TreeNodeBinding SelectAction Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeNodeBinding SelectAction Example</h3>
    
      <asp:TreeView id="BookTreeView"
        Font-Names= "Arial"
        ForeColor="Blue"
        DataSourceID="BookXmlDataSource"
        EnableClientScript="false" 
        OnSelectedNodeChanged="Node_Changed"
        OnTreeNodeExpanded="Node_Expanded"
        OnTreeNodeCollapsed="Node_Collapsed"   
        runat="server">
        
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" 
            TextField="Title"
            SelectAction="Expand"/>
          <asp:TreeNodeBinding DataMember="Chapter" 
            TextField="Heading"
            SelectAction="Expand"/>
        </DataBindings>
        
      </asp:TreeView>
      
      <asp:XmlDataSource id="BookXmlDataSource"  
        DataFile="Book.xml"
        runat="server">
      </asp:XmlDataSource>
      
      <br /><br />
      
      <asp:Label id="Message" 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

Lorsque le TreeView contrôle est lié à une source de données, utilisez la SelectAction propriété pour spécifier la valeur à lier à la SelectAction propriété d’un TreeNode objet . Cette relation de liaison affecte tous les TreeNode objets auxquels l’objet TreeNodeBinding est appliqué. La SelectAction propriété est utilisée pour spécifier le ou les événements qui sont déclenchés lorsqu’un nœud est sélectionné.

Notes

Vous pouvez remplacer la SelectAction propriété de manière sélective en définissant directement la SelectAction propriété de chaque nœud.

Le tableau suivant répertorie les options disponibles.

Valeur SelectAction Description
TreeNodeSelectAction.Expand Bascule le nœud entre développé et réduit. Déclenche l’événement TreeNodeExpanded ou l’événement TreeNodeCollapsed , le cas échéant.
TreeNodeSelectAction.None Ne déclenche aucun événement lorsqu'un nœud est sélectionné.
TreeNodeSelectAction.Select Déclenche l'événement SelectedNodeChanged lorsqu'un nœud est sélectionné.
TreeNodeSelectAction.SelectExpand Déclenche les événements SelectedNodeChanged et TreeNodeExpanded lorsqu'un nœud est sélectionné. Les nœuds sont uniquement développés, jamais réduits.

Notes

n’est HoverNodeStyle pas rendu pour un nœud dont la SelectAction propriété est définie sur TreeNodeSelectAction.None.

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

S’applique à

Voir aussi