TreeNodeBinding.SelectAction Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
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.None
en .
El valor de esta propiedad se almacena en estado de vista.