Eventos del control TreeView de servidor Web

Artículo
10/22/2014

Actualización: noviembre 2007

El control TreeView de servidor Web proporciona varios eventos que se pueden programar. Esto permite ejecutar rutinas personalizadas cada vez que se desencadena un evento.

Eventos

Los eventos del control TreeView sólo se desencadenan cuando un usuario interactúa con el control al realizar determinadas operaciones, como seleccionar, expandir o contraer un nodo. Estos eventos no se desencadenan si los métodos de selección, expansión o contracción se invocan automáticamente. Por ejemplo, si llama al método Expand, no se producirá ningún evento.

En la tabla siguiente se describen los eventos compatibles con el control TreeView.

Evento	Descripción
TreeNodeCheckChanged	Se desencadena cuando una casilla de verificación del control TreeView cambia el estado entre los envíos al servidor. Se desencadena una vez por cada objeto TreeNode objete que varía.
SelectedNodeChanged	Se desencadena cuando se selecciona un nodo en el control TreeView.
TreeNodeExpanded	Se desencadena cuando se expande un nodo en el control TreeView.
TreeNodeCollapsed	Se desencadena cuando se contrae un nodo en el control TreeView.
TreeNodePopulate	Se desencadena cuando un nodo, cuya propiedad PopulateOnDemand está definida como true, se expande en el control TreeView.
TreeNodeDataBound	Se desencadena cuando un elemento de datos se enlaza a un nodo en el control TreeView.

Ejemplo

Evento SelectedNodeChanged

En el ejemplo de código siguiente se muestra cómo se controla el evento SelectedNodeChanged y se obtiene acceso a la propiedad SelectedNode que desencadena el evento. El evento establece el texto de MyLabel para que sea el texto de la propiedad ToolTip de la propiedad de clase SelectedNode.

Protected Sub TreeView1_SelectedNodeChanged(ByVal sender As Object, ByVal e As System.EventArgs) Handles TreeView1.SelectedNodeChanged
    MyLabel.Text = TreeView1.SelectedNode.ToolTip

End Sub

protected void TreeView1_SelectedNodeChanged(object sender, EventArgs e)
{
    MyLabel.Text = TreeView1.SelectedNode.ToolTip;
}

Eventos TreeNodeExpanded y TreeNodeCollapsed

En el ejemplo de código siguiente se muestra cómo se controla el evento TreeNodeCollapsed y el evento TreeNodeExpanded y cómo se obtiene acceso al objeto TreeNode que se ha contraído o expandido.

Protected Sub TreeView1_TreeNodeCollapsed(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.TreeNodeEventArgs) Handles TreeView1.TreeNodeCollapsed
    MyLabel.Text = "You collapsed the " & e.Node.Value & " node."
End Sub

Protected Sub TreeView1_TreeNodeExpanded(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.TreeNodeEventArgs) Handles TreeView1.TreeNodeExpanded
    MyLabel.Text = "You expanded the " & e.Node.Value & " node."
End Sub

protected void TreeView1_TreeNodeCollapsed(object sender, TreeNodeEventArgs e)
{
    MyLabel.Text = "You collapsed the " + e.Node.Value + " node.";
}
protected void TreeView1_TreeNodeExpanded(object sender, TreeNodeEventArgs e)
{
    MyLabel.Text = "You expanded the " + e.Node.Value + " node.";
}

Evento TreeNodePopulate

En el ejemplo de código siguiente se muestra cómo se controla el evento TreeNodePopulate y se agrega a continuación un nuevo objeto TreeNode a la colección ChildNodes del nodo que desencadenó el evento.

Protected Sub TreeView1_TreeNodePopulate(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.TreeNodeEventArgs) Handles TreeView1.TreeNodePopulate
    e.Node.ChildNodes.Add(New TreeNode("New Node Populated on Demand"))
End Sub

protected void TreeView1_TreeNodePopulate(object sender, TreeNodeEventArgs e)
{
    e.Node.ChildNodes.Add(new TreeNode("New Node Populated on Demand"));
}