TreeNodeBinding.SelectAction Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

Obtiene o establece los eventos que se deben provocar al seleccionar el nodo al que se aplica el objeto 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

Valor de propiedad

TreeNodeSelectAction

Uno de los valores de TreeNodeSelectAction. De manera predeterminada, es TreeNodeSelectAction.Select.

Ejemplos

Esta sección contiene dos ejemplos de código. En el primer ejemplo de código se muestra cómo usar la SelectAction propiedad para especificar qué evento se genera cuando se hace clic en un nodo. El segundo ejemplo de código proporciona datos XML de ejemplo para el primer ejemplo de código.

En el ejemplo siguiente se muestra cómo usar la SelectAction propiedad para especificar qué evento se genera cuando se hace clic en un nodo. Para que este ejemplo funcione correctamente, debe copiar los datos XML de ejemplo, proporcionados después de este ejemplo de código, en un archivo denominado 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>

En el ejemplo de código siguiente se proporcionan datos XML de ejemplo para el ejemplo de código anterior.

<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>

Comentarios

Cuando el TreeView control está enlazado a un origen de datos, utilice la SelectAction propiedad para especificar el valor que se va a enlazar a la SelectAction propiedad de un TreeNode objeto . Esta relación de enlace afecta a todos los TreeNode objetos a los que se aplica el TreeNodeBinding objeto. La SelectAction propiedad se usa para especificar qué evento o eventos se generan cuando se selecciona un nodo.

Nota

Puede invalidar selectivamente la SelectAction propiedad estableciendo la SelectAction propiedad de cada nodo directamente.

En la siguiente tabla se enumeran las opciones disponibles.

Valor de SelectAction Descripción
TreeNodeSelectAction.Expand Alterna el nodo entre expandido y contraído. Genera el TreeNodeExpanded evento o el TreeNodeCollapsed evento, según corresponda.
TreeNodeSelectAction.None No provoca ningún evento cuando se selecciona un nodo.
TreeNodeSelectAction.Select Genera el evento SelectedNodeChanged cuando se selecciona un nodo.
TreeNodeSelectAction.SelectExpand Provoca los eventos SelectedNodeChanged y TreeNodeExpanded cuando se selecciona un nodo. Los nodos solo se expanden, nunca se contraen.

Nota

HoverNodeStyle No se representa para un nodo con su SelectAction propiedad establecida TreeNodeSelectAction.Noneen .

El valor de esta propiedad se almacena en estado de vista.

Se aplica a

Consulte también