TreeNodeBinding.SelectAction Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ottiene o imposta gli eventi da generare quando si seleziona un nodo a cui è applicato l'oggetto TreeNodeBinding.

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

Valore della proprietà

TreeNodeSelectAction

Uno dei valori di TreeNodeSelectAction. Il valore predefinito è TreeNodeSelectAction.Select.

Esempio

In questa sezione sono riportati due esempi di codice. Nel primo esempio di codice viene illustrato come utilizzare la SelectAction proprietà per specificare l'evento generato quando si fa clic su 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 SelectAction proprietà per specificare l'evento generato quando si fa clic su 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 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>

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

Quando il TreeView controllo è associato a un'origine dati, utilizzare la SelectAction proprietà per specificare il valore da associare alla SelectAction proprietà di un TreeNode oggetto . Questa relazione di associazione influisce su tutti gli TreeNode oggetti a cui viene applicato l'oggetto TreeNodeBinding . La SelectAction proprietà viene utilizzata per specificare l'evento o gli eventi generati quando viene selezionato un nodo.

Nota

È possibile eseguire l'override selettiva della SelectAction proprietà impostando direttamente la SelectAction proprietà di ogni nodo.

Nella tabella seguente sono elencate le opzioni disponibili.

Valore della proprietà SelectAction Descrizione
TreeNodeSelectAction.Expand Attiva o disattiva il nodo tra espanso e compresso. Genera l'evento TreeNodeExpanded o l'evento TreeNodeCollapsed , in base alle esigenze.
TreeNodeSelectAction.None Non genera eventi quando si seleziona un nodo.
TreeNodeSelectAction.Select Genera l'evento SelectedNodeChanged quando viene selezionato un nodo.
TreeNodeSelectAction.SelectExpand Genera gli eventi SelectedNodeChanged e TreeNodeExpanded quando si seleziona un nodo. I nodi vengono espansi e non vengono mai compressi.

Nota

Il rendering dell'oggetto HoverNodeStyle non viene eseguito per un nodo con la relativa SelectAction proprietà impostata su TreeNodeSelectAction.None.

Il valore di questa proprietà viene archiviato nello stato di visualizzazione.

Si applica a

Vedi anche