Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase TreeView

 

Publicado: octubre de 2016

Muestra datos jerárquicos, como una tabla de contenido, en una estructura de árbol.

Espacio de nombres:   System.Web.UI.WebControls
Ensamblado:  System.Web (en System.Web.dll)


[ControlValuePropertyAttribute("SelectedValue")]
public class TreeView : HierarchicalDataBoundControl, IPostBackEventHandler, 
	IPostBackDataHandler, ICallbackEventHandler

NombreDescripción
System_CAPS_pubmethodTreeView()

Inicializa una nueva instancia de la clase TreeView.

NombreDescripción
System_CAPS_pubpropertyAccessKey

Obtiene o establece la clave de acceso que permite navegar rápidamente al control de servidor Web.(Heredado de WebControl).

System_CAPS_protpropertyAdapter

Obtiene el adaptador específico del explorador para el control.(Heredado de Control).

System_CAPS_pubpropertyAppRelativeTemplateSourceDirectory

Obtiene o establece el directorio virtual relativa a la aplicación de la Page o UserControl objeto que contiene este control.(Heredado de Control).

System_CAPS_pubpropertyAttributes

Obtiene la colección de atributos arbitrarios (sólo para representación) que no corresponden a propiedades del control.(Heredado de WebControl).

System_CAPS_pubpropertyAutoGenerateDataBindings

Obtiene o establece un valor que indica si el TreeView control genera automáticamente los enlaces de nodo de árbol.

System_CAPS_pubpropertyBackColor

Obtiene o establece el color de fondo del control de servidor Web.(Heredado de WebControl).

System_CAPS_pubpropertyBindingContainer

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Obtiene el control que contiene el enlace de datos del control.(Heredado de Control).

System_CAPS_pubpropertyBorderColor

Obtiene o establece el color del borde del control Web.(Heredado de WebControl).

System_CAPS_pubpropertyBorderStyle

Obtiene o establece el estilo de borde del control de servidor Web.(Heredado de WebControl).

System_CAPS_pubpropertyBorderWidth

Obtiene o establece el ancho del borde del control de servidor Web.(Heredado de WebControl).

System_CAPS_pubpropertyCheckedNodes

Obtiene una colección de TreeNode objetos que representan los nodos en el TreeView control que muestra una casilla activada.

System_CAPS_protpropertyChildControlsCreated

Obtiene un valor que indica si se crearon los controles secundarios del control de servidor.(Heredado de Control).

System_CAPS_pubpropertyClientID

Obtiene el id. de control para marcado HTML que se genera por ASP.NET.(Heredado de Control).

System_CAPS_pubpropertyClientIDMode

Obtiene o establece el algoritmo que se usa para generar el valor de la ClientID propiedad.(Heredado de Control).

System_CAPS_protpropertyClientIDSeparator

Obtiene un valor de carácter que representa el carácter separador utilizado en el ClientID propiedad.(Heredado de Control).

System_CAPS_pubpropertyCollapseImageToolTip

Obtiene o establece la información sobre herramientas para la imagen que se muestra para el indicador de nodo contraíble.

System_CAPS_pubpropertyCollapseImageUrl

Obtiene o establece la dirección URL de una imagen personalizada para el indicador de nodo contraíble.

System_CAPS_protpropertyContext

Obtiene el HttpContext objeto asociado con el control de servidor para la solicitud Web actual.(Heredado de Control).

System_CAPS_pubpropertyControls

Obtiene un ControlCollection objeto que representa los controles secundarios de un control de servidor especificado en la jerarquía de la interfaz de usuario.(Heredado de Control).

System_CAPS_pubpropertyControlStyle

Obtiene el estilo del control de servidor Web. Esta propiedad la usan principalmente los programadores de controles.(Heredado de WebControl).

System_CAPS_pubpropertyControlStyleCreated

Obtiene un valor que indica si un Style se ha creado el objeto para el ControlStyle propiedad. Esta propiedad se utiliza principalmente los programadores de controles.(Heredado de WebControl).

System_CAPS_pubpropertyCssClass

Obtiene o establece la clase de hoja de estilos en cascada (CSS) representada por el control de servidor Web en el cliente.(Heredado de WebControl).

System_CAPS_pubpropertyDataBindings

Obtiene una colección de TreeNodeBinding objetos que definen la relación entre un elemento de datos y el nodo que se enlaza.

System_CAPS_pubpropertyDataItemContainer

Obtiene una referencia al contenedor de nomenclatura si implementa el contenedor de nomenclatura IDataItemContainer.(Heredado de Control).

System_CAPS_pubpropertyDataKeysContainer

Obtiene una referencia al contenedor de nomenclatura si implementa el contenedor de nomenclatura IDataKeysControl.(Heredado de Control).

System_CAPS_pubpropertyDataSource

Obtiene o establece el objeto del que el control enlazado a datos recupera su lista de elementos de datos.(Heredado de BaseDataBoundControl).

System_CAPS_pubpropertyDataSourceID

Obtiene o establece el identificador del control desde el que el control enlazado a datos recupera su lista de elementos de datos.(Heredado de HierarchicalDataBoundControl).

System_CAPS_protpropertyDesignMode

Obtiene un valor que indica si se está utilizando un control en una superficie de diseño.(Heredado de Control).

System_CAPS_pubpropertyEnableClientScript

Obtiene o establece un valor que indica si el TreeView control representa el script de cliente para controlar la expansión y contracción de eventos.

System_CAPS_pubpropertyEnabled

Obtiene o establece un valor que indica si está habilitado el control de servidor Web.(Heredado de WebControl).

System_CAPS_pubpropertyEnableTheming

Obtiene o establece un valor que indica si se aplican temas a este control.(Heredado de WebControl).

System_CAPS_pubpropertyEnableViewState

Obtiene o establece un valor que indica si el control de servidor conserva su estado de vista, así como el estado de vista de los controles secundarios que contiene, al cliente solicitante.(Heredado de Control).

System_CAPS_protpropertyEvents

Obtiene una lista de delegados de controladores de eventos para el control. Esta propiedad es de sólo lectura.(Heredado de Control).

System_CAPS_pubpropertyExpandDepth

Obtiene o establece el número de niveles que se expanden cuando un TreeView control se muestra por primera vez.

System_CAPS_pubpropertyExpandImageToolTip

Obtiene o establece la información sobre herramientas para la imagen que se muestra para el indicador de nodo expansible.

System_CAPS_pubpropertyExpandImageUrl

Obtiene o establece la dirección URL de una imagen personalizada para el indicador de nodo expansible.

System_CAPS_pubpropertyFont

Obtiene las propiedades de fuente asociadas con el control de servidor Web.(Heredado de WebControl).

System_CAPS_pubpropertyForeColor

Obtiene o establece el color de primer plano (normalmente el color del texto) del control de servidor Web.(Heredado de WebControl).

System_CAPS_pubpropertyHasAttributes

Obtiene un valor que indica si el control tiene un atributo del conjunto.(Heredado de WebControl).

System_CAPS_protpropertyHasChildViewState

Obtiene un valor que indica si los controles secundarios del control de servidor actual tienen cualquier configuración de estado de vista guardado.(Heredado de Control).

System_CAPS_pubpropertyHeight

Obtiene o establece el alto del control de servidor Web.(Heredado de WebControl).

System_CAPS_pubpropertyHoverNodeStyle

Obtiene una referencia a la TreeNodeStyle objeto que permite establecer el aspecto de un nodo cuando el puntero del mouse se coloca sobre él.

System_CAPS_pubpropertyID

Obtiene o establece el identificador de programación asignado al control de servidor.(Heredado de Control).

System_CAPS_protpropertyIdSeparator

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Obtiene el carácter utilizado para separar los identificadores de control.(Heredado de Control).

System_CAPS_pubpropertyImageSet

Obtiene o establece el grupo de imágenes a utilizar para el TreeView control.

System_CAPS_protpropertyInitialized

Obtiene un valor que indica si se ha inicializado el control enlazado a datos.(Heredado de BaseDataBoundControl).

System_CAPS_protpropertyIsBoundUsingDataSourceID

Obtiene un valor que indica si el DataSourceID se establece la propiedad.(Heredado de BaseDataBoundControl).

System_CAPS_protpropertyIsChildControlStateCleared

Obtiene un valor que indica si los controles incluidos en este control tienen estado de control.(Heredado de Control).

System_CAPS_protpropertyIsDataBindingAutomatic

Obtiene un valor que indica si el enlace de datos es automático.(Heredado de BaseDataBoundControl).

System_CAPS_protpropertyIsEnabled

Obtiene un valor que indica si el control está habilitado.(Heredado de WebControl).

System_CAPS_protpropertyIsTrackingViewState

Obtiene un valor que indica si el control de servidor está guardando los cambios en su estado de vista.(Heredado de Control).

System_CAPS_protpropertyIsUsingModelBinders

Cuando se implementa en una clase derivada, obtiene un valor que indica si el control está usando los enlazadores de modelos.(Heredado de BaseDataBoundControl).

System_CAPS_protpropertyIsViewStateEnabled

Obtiene un valor que indica si el estado de vista está habilitado para este control.(Heredado de Control).

System_CAPS_pubpropertyLeafNodeStyle

Obtiene una referencia a la TreeNodeStyle objeto que permite establecer el aspecto de los nodos hoja.

System_CAPS_pubpropertyLevelStyles

Obtiene una colección de Style objetos que representan los estilos de nodo en los niveles individuales del árbol.

System_CAPS_pubpropertyLineImagesFolder

Obtiene o establece la ruta de acceso a una carpeta que contiene las imágenes de línea que se usan para conectar los nodos secundarios a los nodos primarios.

System_CAPS_protpropertyLoadViewStateByID

Obtiene un valor que indica si el control participa en la carga su estado de vista por ID en lugar de índice.(Heredado de Control).

System_CAPS_pubpropertyMaxDataBindDepth

Obtiene o establece el número máximo de niveles del árbol a enlazar con el TreeView control.

System_CAPS_pubpropertyNamingContainer

Obtiene una referencia al control de servidor de nombres del contenedor, que crea un espacio de nombres único para diferenciar los distintos controles de servidor con el mismo Control.ID valor de propiedad.(Heredado de Control).

System_CAPS_pubpropertyNodeIndent

Obtiene o establece la cantidad de sangría (en píxeles) para el elemento secundario de los nodos de la TreeView control.

System_CAPS_pubpropertyNodes

Obtiene una colección de TreeNode objetos que representa los nodos raíz en el TreeView control.

System_CAPS_pubpropertyNodeStyle

Obtiene una referencia a la TreeNodeStyle objeto que permite establecer la apariencia predeterminada de los nodos en el TreeView control.

System_CAPS_pubpropertyNodeWrap

Obtiene o establece un valor que indica si el texto se ajusta en un nodo cuando el nodo se queda sin espacio.

System_CAPS_pubpropertyNoExpandImageUrl

Obtiene o establece la dirección URL de una imagen personalizada para el indicador de nodo no expansible.

System_CAPS_pubpropertyPage

Obtiene una referencia a la Page instancia que contiene el control de servidor.(Heredado de Control).

System_CAPS_pubpropertyParent

Obtiene una referencia al control principal del control de servidor en la jerarquía de controles de página.(Heredado de Control).

System_CAPS_pubpropertyParentNodeStyle

Obtiene una referencia a la TreeNodeStyle objeto que permite establecer el aspecto de los nodos primarios en el TreeView control.

System_CAPS_pubpropertyPathSeparator

Obtiene o establece el carácter que se utiliza para delimitar los valores de nodo especificados por la ValuePath propiedad.

System_CAPS_pubpropertyPopulateNodesFromClient

Obtiene o establece un valor que indica si los datos del nodo se rellenan a petición del cliente.

System_CAPS_pubpropertyRenderingCompatibility

Obtiene un valor que especifica será compatible con la versión de ASP.NET que se representa en HTML.(Heredado de Control).

System_CAPS_protpropertyRequiresDataBinding

Obtiene o establece un valor que indica si el DataBind debe llamar al método.(Heredado de BaseDataBoundControl).

System_CAPS_pubpropertyRootNodeStyle

Obtiene una referencia a la TreeNodeStyle objeto que permite establecer la apariencia del nodo raíz en el TreeView control.

System_CAPS_pubpropertySelectedNode

Obtiene un TreeNode objeto que representa el nodo seleccionado en el TreeView control.

System_CAPS_pubpropertySelectedNodeStyle

Obtiene el TreeNodeStyle objeto que controla el aspecto del nodo seleccionado en el TreeView control.

System_CAPS_pubpropertySelectedValue

Obtiene el valor del nodo seleccionado.

System_CAPS_pubpropertyShowCheckBoxes

Obtiene o establece un valor que indica qué tipos de nodo mostrarán una casilla en el TreeView control.

System_CAPS_pubpropertyShowExpandCollapse

Obtiene o establece un valor que indica si se muestran los indicadores de nodo de expansión.

System_CAPS_pubpropertyShowLines

Obtiene o establece un valor que indica si se muestran las líneas que conectan los nodos secundarios a los nodos primarios.

System_CAPS_pubpropertySite

Obtiene información sobre el contenedor que hospeda el control actual cuando se representa en una superficie de diseño.(Heredado de Control).

System_CAPS_pubpropertySkinID

Obtiene o establece la máscara que se aplica al control.(Heredado de WebControl).

System_CAPS_pubpropertySkipLinkText

Obtiene o establece un valor que se utiliza para representar texto alternativo para los lectores de pantalla que omitan el contenido del control.

System_CAPS_pubpropertyStyle

Obtiene una colección de atributos de texto que se representan como un atributo de estilo en la etiqueta externa del control de servidor Web.(Heredado de WebControl).

System_CAPS_pubpropertySupportsDisabledAttribute

Obtiene un valor que indica si el control debe establecer en "disabled" el atributo disabled del elemento HTML representado cuando el valor de la propiedad IsEnabled del control es false.(Heredado de BaseDataBoundControl).

System_CAPS_pubpropertyTabIndex

Obtiene o establece el índice de tabulación del control de servidor Web.(Heredado de WebControl).

System_CAPS_protpropertyTagKey

Obtiene el valor System.Web.UI.HtmlTextWriterTag del control TreeView.(Invalida WebControl.TagKey).

System_CAPS_protpropertyTagName

Obtiene el nombre de la etiqueta del control. Esta propiedad la usan principalmente los programadores de controles.(Heredado de WebControl).

System_CAPS_pubpropertyTarget

Obtiene o establece la ventana o marco destino para mostrar el contenido de la página Web que está asociado a un nodo.

System_CAPS_pubpropertyTemplateControl

Obtiene o establece una referencia a la plantilla que contiene este control.(Heredado de Control).

System_CAPS_pubpropertyTemplateSourceDirectory

Obtiene el directorio virtual de la Page o UserControl que contiene el control de servidor actual.(Heredado de Control).

System_CAPS_pubpropertyToolTip

Obtiene o establece el texto mostrado cuando el puntero del mouse se sitúa sobre el control de servidor Web.(Heredado de WebControl).

System_CAPS_pubpropertyUniqueID

Obtiene el identificador único calificado jerárquicamente para el control de servidor.(Heredado de Control).

System_CAPS_pubpropertyValidateRequestMode

Obtiene o establece un valor que indica si el control comprueba la entrada del cliente desde el Explorador de valores potencialmente peligrosos.(Heredado de Control).

System_CAPS_protpropertyViewState

Obtiene un diccionario de información de estado que permite guardar y restaurar el estado de vista de un control de servidor a través de varias solicitudes de la misma página.(Heredado de Control).

System_CAPS_protpropertyViewStateIgnoresCase

Obtiene un valor que indica si la StateBag objeto distingue mayúsculas de minúsculas.(Heredado de Control).

System_CAPS_pubpropertyViewStateMode

Obtiene o establece el modo de estado de vista de este control.(Heredado de Control).

System_CAPS_pubpropertyVisible

Obtiene o establece un valor que indica si el control se representa como interfaz de usuario en la página.(Invalida Control.Visible).

System_CAPS_pubpropertyWidth

Obtiene o establece el ancho del control de servidor web.(Heredado de WebControl).

NombreDescripción
System_CAPS_protmethodAddAttributesToRender(HtmlTextWriter)

Agrega atributos y estilos que se deben representar HTML especificado HtmlTextWriter control.(Invalida WebControl.AddAttributesToRender(HtmlTextWriter)).

System_CAPS_protmethodAddedControl(Control, Int32)

Se llama después de que se agrega un control secundario a la Controls colección de la Control objeto.(Heredado de Control).

System_CAPS_protmethodAddParsedSubObject(Object)

Notifica al control de servidor que se analizó un elemento, ya sea XML o HTML, y agrega el elemento al objeto ControlCollection del control del servidor.(Heredado de Control).

System_CAPS_pubmethodApplyStyle(Style)

Copia los elementos no vacíos del estilo especificado en el control Web, sobrescribiendo los elementos de estilo existentes del control. Este método se utiliza principalmente los programadores de controles.(Heredado de WebControl).

System_CAPS_pubmethodApplyStyleSheetSkin(Page)

Se aplica a las propiedades de estilo definidas en la hoja de estilo de página para el control.(Heredado de Control).

System_CAPS_protmethodBeginRenderTracing(TextWriter, Object)

Comienza el seguimiento de tiempo de diseño de datos de representación.(Heredado de Control).

System_CAPS_protmethodBuildProfileTree(String, Boolean)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Recopila información sobre el control de servidor y la pasa a la Trace propiedad que se mostrará cuando el seguimiento está habilitado para la página.(Heredado de Control).

System_CAPS_protmethodClearCachedClientID()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Establece la caché ClientID valor a null.(Heredado de Control).

System_CAPS_protmethodClearChildControlState()

Elimina la información de estado de control para los controles secundarios del control de servidor.(Heredado de Control).

System_CAPS_protmethodClearChildState()

Elimina la información de estado de vista y el estado de control para los controles secundarios todos del control de servidor.(Heredado de Control).

System_CAPS_protmethodClearChildViewState()

Elimina la información de estado de vista para todo el servidor controles secundarios del control.(Heredado de Control).

System_CAPS_protmethodClearEffectiveClientIDMode()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Establece el ClientIDMode propiedad de la instancia actual del control y de todos los controles secundarios a Inherit.(Heredado de Control).

System_CAPS_pubmethodCollapseAll()

Cierra todos los nodos en el árbol.

System_CAPS_protmethodConfirmInitState()

Establece el estado inicializado del control enlazado a datos.(Heredado de BaseDataBoundControl).

System_CAPS_pubmethodCopyBaseAttributes(WebControl)

Copia las propiedades que no están encapsuladas por la Style objeto desde el control de servidor Web especificado al control de servidor Web que se llama a este método. Este método se usa principalmente los programadores de controles.(Heredado de WebControl).

System_CAPS_protmethodCreateChildControls()

Lo llama el marco de páginas ASP.NET para indicar a los controles de servidor que usan la implementación basada en composición que creen los controles secundarios que contengan como forma de preparar la devolución o representación de los datos.(Heredado de Control).

System_CAPS_protmethodCreateControlCollection()

Crea una colección para almacenar controles secundarios.(Invalida Control.CreateControlCollection()).

System_CAPS_protmethodCreateControlStyle()

Crea el objeto de estilo que se usa internamente el WebControl propiedades relacionadas con la clase para implementar todos los estilos. Este método se usa principalmente los programadores de controles.(Heredado de WebControl).

System_CAPS_protmethodCreateNode()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Devuelve una nueva instancia de la clase TreeNode. El CreateNode es un método auxiliar.

System_CAPS_pubmethodDataBind()

Llamadas del DataBind método de la clase base.(Invalida BaseDataBoundControl.DataBind()).

System_CAPS_protmethodDataBind(Boolean)

Enlaza un origen de datos para el control de servidor invocado y todos sus controles secundarios con una opción para generar el DataBinding eventos.(Heredado de Control).

System_CAPS_protmethodDataBindChildren()

Enlaza un origen de datos a los controles secundarios del control de servidor.(Heredado de Control).

System_CAPS_pubmethodDispose()

Habilita un control de servidor realizar la limpieza final antes de que se libere de la memoria.(Heredado de Control).

System_CAPS_protmethodEndRenderTracing(TextWriter, Object)

Finaliza el seguimiento de tiempo de diseño de datos de representación.(Heredado de Control).

System_CAPS_protmethodEnsureChildControls()

Determina si el control de servidor contiene controles secundarios. Si no es así, crea controles secundarios.(Heredado de Control).

System_CAPS_protmethodEnsureDataBound()

Llamadas del DataBind método si el DataSourceID se establece la propiedad y el control enlazado a datos está marcado para que requiera el enlace.(Heredado de BaseDataBoundControl).

System_CAPS_protmethodEnsureID()

Crea un identificador para los controles que no tienen un identificador asignado.(Heredado de Control).

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_pubmethodExpandAll()

Abre todos los nodos en el árbol.

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object).

System_CAPS_pubmethodFindControl(String)

Busca el contenedor de nomenclatura actual para un control de servidor con el parámetro id parámetro.(Heredado de Control).

System_CAPS_protmethodFindControl(String, Int32)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Busca el contenedor de nomenclatura actual para un control de servidor con el parámetro id y un entero especificado en el pathOffset parámetro, lo que ayuda en la búsqueda. No se debe reemplazar esta versión de la FindControl (método).(Heredado de Control).

System_CAPS_pubmethodFindNode(String)

Recupera la TreeNode objeto en el TreeView control en la ruta de acceso del valor especificado.

System_CAPS_pubmethodFocus()

Establece el foco en un control de entrada.(Heredado de Control).

System_CAPS_protmethodGetCallbackResult()

Devuelve el resultado de un evento de devolución de llamada que tiene como destino un control.

System_CAPS_protmethodGetData(String)

Recupera un HierarchicalDataSourceView que el control enlazado a datos se utiliza para realizar operaciones de datos de objeto.(Heredado de HierarchicalDataBoundControl).

System_CAPS_protmethodGetDataSource()

Recupera el IHierarchicalDataSource que está asociado el control enlazado a datos, si existe.(Heredado de HierarchicalDataBoundControl).

System_CAPS_protmethodGetDesignModeState()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Obtiene los datos de tiempo de diseño para un control.(Heredado de Control).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetRouteUrl(Object)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.(Heredado de Control).

System_CAPS_pubmethodGetRouteUrl(RouteValueDictionary)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.(Heredado de Control).

System_CAPS_pubmethodGetRouteUrl(String, Object)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta.(Heredado de Control).

System_CAPS_pubmethodGetRouteUrl(String, RouteValueDictionary)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta.(Heredado de Control).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodGetUniqueIDRelativeTo(Control)

Devuelve la parte fija de la UniqueID propiedad del control especificado.(Heredado de Control).

System_CAPS_pubmethodHasControls()

Determina si el control de servidor contiene todos los controles secundarios.(Heredado de Control).

System_CAPS_protmethodHasEvents()

Devuelve un valor que indica si se registran eventos para el control o los controles secundarios.(Heredado de Control).

System_CAPS_protmethodIsLiteralContent()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Determina si el control de servidor alberga únicamente contenido literal.(Heredado de Control).

System_CAPS_protmethodLoadControlState(Object)

Restaura la información de estado de control de una solicitud de página anterior guardada por el SaveControlState (método).(Heredado de Control).

System_CAPS_protmethodLoadPostData(String, NameValueCollection)

Procesa los datos de postback del control TreeView.

System_CAPS_protmethodLoadViewState(Object)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Carga el estado de vista guardado previamente del control TreeView.(Invalida WebControl.LoadViewState(Object)).

System_CAPS_protmethodMapPathSecure(String)

Recupera la ruta de acceso física que se asigna una ruta de acceso virtual absoluta o relativa, a.(Heredado de Control).

System_CAPS_protmethodMarkAsDataBound()

Establece el estado del control en estado de vista como correctamente enlazado a datos.(Heredado de HierarchicalDataBoundControl).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_pubmethodMergeStyle(Style)

Copia los elementos no vacíos del estilo especificado en el Web controlan pero no sobrescribirá ningún elemento de estilo existente del control. Este método se usa principalmente los programadores de controles.(Heredado de WebControl).

System_CAPS_protmethodOnBubbleEvent(Object, EventArgs)

Determina si el evento del control de servidor se pasa a la jerarquía de control de servidor de la interfaz de usuario (UI) de la página.(Heredado de Control).

System_CAPS_protmethodOnDataBinding(EventArgs)

Genera el evento DataBinding.(Heredado de Control).

System_CAPS_protmethodOnDataBound(EventArgs)

Genera el evento DataBound.(Heredado de BaseDataBoundControl).

System_CAPS_protmethodOnDataPropertyChanged()

Se llama cuando se cambia una de las propiedades de identificación del origen de datos base, para volver a enlazar el control enlazado a datos a sus datos.(Heredado de HierarchicalDataBoundControl).

System_CAPS_protmethodOnDataSourceChanged(Object, EventArgs)

Llamado cuando el IHierarchicalDataSource instancia que funciona el control enlazado a datos con genera el DataSourceChanged eventos.(Heredado de HierarchicalDataBoundControl).

System_CAPS_protmethodOnInit(EventArgs)

Genera el evento Init.(Invalida BaseDataBoundControl.OnInit(EventArgs)).

System_CAPS_protmethodOnLoad(EventArgs)

Controla el Load eventos.(Heredado de HierarchicalDataBoundControl).

System_CAPS_protmethodOnPagePreLoad(Object, EventArgs)

Establece el estado inicializado del control enlazado a datos antes de cargar el control.(Heredado de HierarchicalDataBoundControl).

System_CAPS_protmethodOnPreRender(EventArgs)
System_CAPS_protmethodOnSelectedNodeChanged(EventArgs)

Genera el SelectedNodeChanged eventos de la TreeView control.

System_CAPS_protmethodOnTreeNodeCheckChanged(TreeNodeEventArgs)

Genera el TreeNodeCheckChanged eventos de la TreeView control.

System_CAPS_protmethodOnTreeNodeCollapsed(TreeNodeEventArgs)

Genera el TreeNodeCollapsed eventos de la TreeView control.

System_CAPS_protmethodOnTreeNodeDataBound(TreeNodeEventArgs)

Genera el TreeNodeDataBound eventos de la TreeView control.

System_CAPS_protmethodOnTreeNodeExpanded(TreeNodeEventArgs)

Genera el TreeNodeExpanded eventos de la TreeView control.

System_CAPS_protmethodOnTreeNodePopulate(TreeNodeEventArgs)

Genera el TreeNodePopulate eventos de la TreeView control.

System_CAPS_protmethodOnUnload(EventArgs)

Genera el evento Unload.(Heredado de Control).

System_CAPS_protmethodOpenFile(String)

Obtiene un Stream utilizado para leer un archivo.(Heredado de Control).

System_CAPS_protmethodPerformDataBinding()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Crea todos los nodos basándose en el origen de datos.(Invalida HierarchicalDataBoundControl.PerformDataBinding()).

System_CAPS_protmethodPerformSelect()

Recupera los datos del origen de datos asociado.(Heredado de HierarchicalDataBoundControl).

System_CAPS_protmethodRaiseBubbleEvent(Object, EventArgs)

Asigna los orígenes del evento y su información al elemento primario del control.(Heredado de Control).

System_CAPS_protmethodRaiseCallbackEvent(String)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Genera el evento de devolución de llamada con los argumentos especificados.

System_CAPS_protmethodRaisePostBackEvent(String)

Habilita el TreeView control procese un evento que se desencadena cuando un formulario se envía al servidor. El RaisePostBackEvent es un método auxiliar para el ICallbackEventHandler.RaiseCallbackEvent (método).

System_CAPS_protmethodRaisePostDataChangedEvent()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Indica el TreeView control para notificar a la aplicación ASP.NET que el estado del control ha cambiado.

System_CAPS_protmethodRemovedControl(Control)

Se llama después de que se quita un control secundario de la Controls colección de la Control objeto.(Heredado de Control).

System_CAPS_protmethodRender(HtmlTextWriter)

Representa el control en el sistema de escritura HTML especificado.(Heredado de WebControl).

System_CAPS_pubmethodRenderBeginTag(HtmlTextWriter)

Representa la etiqueta HTML de apertura del control en el escritor especificado.(Invalida WebControl.RenderBeginTag(HtmlTextWriter)).

System_CAPS_protmethodRenderChildren(HtmlTextWriter)

Envía el contenido de los elementos secundarios de un control de servidor a un HtmlTextWriter objeto, que escribe el contenido que se va a representar en el cliente.(Heredado de Control).

System_CAPS_protmethodRenderContents(HtmlTextWriter)

Representa los nodos en el TreeView control.(Invalida WebControl.RenderContents(HtmlTextWriter)).

System_CAPS_pubmethodRenderControl(HtmlTextWriter)

Genera el contenido del control de servidor a un HtmlTextWriter de objeto y almacena información de seguimiento sobre el control si está habilitado el seguimiento.(Heredado de Control).

System_CAPS_protmethodRenderControl(HtmlTextWriter, ControlAdapter)

Genera el contenido del control de servidor a un HtmlTextWriter objeto usando una URL ControlAdapter objeto.(Heredado de Control).

System_CAPS_pubmethodRenderEndTag(HtmlTextWriter)

Representa la etiqueta HTML de cierre del control en el escritor especificado.(Invalida WebControl.RenderEndTag(HtmlTextWriter)).

System_CAPS_protmethodResolveAdapter()

Obtiene el adaptador de control responsable de representar el control especificado.(Heredado de Control).

System_CAPS_pubmethodResolveClientUrl(String)

Obtiene una dirección URL que se puede usar el explorador.(Heredado de Control).

System_CAPS_pubmethodResolveUrl(String)

Convierte una dirección URL en una que se puede usar en el cliente solicitante.(Heredado de Control).

System_CAPS_protmethodSaveControlState()

Guarda los cambios de estado del control de servidor que se produjeron desde la hora en que la página volvió a publicarse en el servidor.(Heredado de Control).

System_CAPS_protmethodSaveViewState()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Guarda el estado del control TreeView.(Invalida WebControl.SaveViewState()).

System_CAPS_protmethodSetDesignModeState(IDictionary)

Establece los datos en tiempo de diseño para un control.(Heredado de Control).

System_CAPS_protmethodSetNodeDataBound(TreeNode, Boolean)

Permite que una clase derivada establecer si especificado TreeNode control está enlazado a datos.

System_CAPS_protmethodSetNodeDataItem(TreeNode, Object)

Permite que una clase derivada establecer el elemento de datos especificado TreeNode control.

System_CAPS_protmethodSetNodeDataPath(TreeNode, String)

Permite que una clase derivada establecer la ruta de acceso de datos especificado TreeNode control.

System_CAPS_pubmethodSetRenderMethodDelegate(RenderMethod)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en el control principal.(Heredado de Control).

System_CAPS_pubmethodSetTraceData(Object, Object)

Conjuntos de datos de tiempo de diseño realiza un seguimiento de procesamiento de datos, utilizando la clave de datos de seguimiento y el valor de datos de seguimiento de seguimiento.(Heredado de Control).

System_CAPS_pubmethodSetTraceData(Object, Object, Object)

Conjuntos de datos de tiempo de diseño realiza un seguimiento de procesamiento de datos, utilizando el objeto de seguimiento, la clave de datos de seguimiento y el valor de datos de seguimiento de traza.(Heredado de Control).

System_CAPS_pubmethodToString()

Devuelve una cadena que representa al objeto actual. (Heredado de Object).

System_CAPS_protmethodTrackViewState()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Realiza el seguimiento de cambios de estado de vista en el TreeView control de modo que pueden almacenarse en la System.Web.UI.StateBag objeto para el control. Esto System.Web.UI.StateBag es accesible a través del Control.ViewState propiedad.(Invalida WebControl.TrackViewState()).

System_CAPS_protmethodValidateDataSource(Object)

Comprueba que el objeto al que se enlaza un control enlazado a datos es compatible con.(Heredado de HierarchicalDataBoundControl).

NombreDescripción
System_CAPS_pubeventDataBinding

Se produce cuando el control de servidor se enlaza a un origen de datos.(Heredado de Control).

System_CAPS_pubeventDataBound

Se produce después de que el control de servidor se enlaza a un origen de datos.(Heredado de BaseDataBoundControl).

System_CAPS_pubeventDisposed

Se produce cuando un control de servidor se libera de la memoria, que es la última fase del ciclo de vida del control de servidor cuando se solicita una página ASP.NET.(Heredado de Control).

System_CAPS_pubeventInit

Se produce cuando se inicializa el control de servidor, que es el primer paso del ciclo de vida.(Heredado de Control).

System_CAPS_pubeventLoad

Se produce cuando el control de servidor se carga en el Page objeto.(Heredado de Control).

System_CAPS_pubeventPreRender

Se produce después de la Control es cargado pero antes de la representación.(Heredado de Control).

System_CAPS_pubeventSelectedNodeChanged

Se produce cuando se selecciona un nodo en el TreeView control.

System_CAPS_pubeventTreeNodeCheckChanged

Se produce cuando una casilla de verificación en el TreeView control cambia de estado entre envíos al servidor.

System_CAPS_pubeventTreeNodeCollapsed

Se produce cuando se contrae un nodo en el TreeView control.

System_CAPS_pubeventTreeNodeDataBound

Se produce cuando un elemento de datos se enlaza a un nodo en el TreeView control.

System_CAPS_pubeventTreeNodeExpanded

Se produce cuando se expande un nodo en el TreeView control.

System_CAPS_pubeventTreeNodePopulate

Se produce cuando un nodo con su PopulateOnDemand propiedad establecida en true se expande en el TreeView control.

System_CAPS_pubeventUnload

Se produce cuando el control de servidor se descarga de la memoria.(Heredado de Control).

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_privmethodIAttributeAccessor.GetAttribute(String)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Obtiene un atributo del control Web con el nombre especificado.(Heredado de WebControl).

System_CAPS_pubinterfaceSystem_CAPS_privmethodIAttributeAccessor.SetAttribute(String, String)

Establece un atributo del control Web en el nombre y valor especificados.(Heredado de WebControl).

System_CAPS_pubinterfaceSystem_CAPS_privmethodICallbackEventHandler.GetCallbackResult()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Devuelve el resultado de un evento de devolución de llamada que tiene como destino un control.

System_CAPS_pubinterfaceSystem_CAPS_privmethodICallbackEventHandler.RaiseCallbackEvent(String)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Genera el evento de devolución de llamada con los argumentos especificados.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.GetDesignModeState()

Para una descripción de este miembro, vea IControlDesignerAccessor.GetDesignModeState.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetDesignModeState(IDictionary)

Para una descripción de este miembro, vea IControlDesignerAccessor.SetDesignModeState.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetOwnerControl(Control)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Para una descripción de este miembro, vea IControlDesignerAccessor.SetOwnerControl.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privmethodIParserAccessor.AddParsedSubObject(Object)

Para una descripción de este miembro, vea IParserAccessor.AddParsedSubObject.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privmethodIPostBackDataHandler.LoadPostData(String, NameValueCollection)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Procesa los datos de postback del control TreeView.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIPostBackDataHandler.RaisePostDataChangedEvent()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Indica el TreeView control para notificar a la aplicación ASP.NET que el estado del control ha cambiado.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIPostBackEventHandler.RaisePostBackEvent(String)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Habilita el TreeView control procese un evento que se desencadena cuando un formulario se envía al servidor.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlBuilderAccessor.ControlBuilder

Para una descripción de este miembro, vea IControlBuilderAccessor.ControlBuilder.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlDesignerAccessor.UserData

Para una descripción de este miembro, vea IControlDesignerAccessor.UserData.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.DataBindings

Para una descripción de este miembro, vea IDataBindingsAccessor.DataBindings.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.HasDataBindings

Para una descripción de este miembro, vea IDataBindingsAccessor.HasDataBindings.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.Expressions

Para una descripción de este miembro, vea IExpressionsAccessor.Expressions.(Heredado de Control).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.HasExpressions

Para una descripción de este miembro, vea IExpressionsAccessor.HasExpressions.(Heredado de Control).

NombreDescripción
System_CAPS_pubmethodEnablePersistedSelection()

Obsoleto.Habilita la selección para que persista en controles de datos que admiten selección y paginación.(Definido por DynamicDataExtensions).

System_CAPS_pubmethodFindDataSourceControl()

Devuelve el origen de datos que está asociado con el control de datos para el control especificado.(Definido por DynamicDataExtensions).

System_CAPS_pubmethodFindFieldTemplate(String)

Devuelve que el contenedor de nomenclatura de la plantilla de campo para la columna especificada en el control especificado.(Definido por DynamicDataExtensions).

System_CAPS_pubmethodFindMetaTable()

Devuelve el objeto de metatabla para el control de datos que contiene.(Definido por DynamicDataExtensions).

El TreeView control se utiliza para mostrar datos jerárquicos, como una tabla de contenido o un directorio de archivo, en una estructura de árbol y admite las siguientes características:

  • Enlace de datos que permiten que los nodos del control para enlazarse a los datos XML, tabulares o relacionales.

  • Sitio de navegación a través de la integración con el SiteMapDataSource control.

  • Texto del nodo que se puede mostrar como texto sin formato o hipervínculos.

  • Acceso mediante programación a la TreeView el modelo de objetos para crear árboles, rellenar nodos, establecer propiedades, y así sucesivamente dinámicamente.

  • Llenado de nodos en el cliente (en exploradores compatibles).

  • La capacidad para mostrar una casilla junto a cada nodo.

  • Personalización del aspecto mediante temas, imágenes definidas por el usuario y estilos.

    System_CAPS_noteNota

    El TreeView control está diseñado para usarse en un UpdatePanel controlar sólo cuando EnableClientScript está establecido en true. UpdatePanel los controles se usan para actualizar regiones seleccionadas de una página en lugar de actualizar toda la página con una devolución de datos. Para obtener más información, consulte UpdatePanel Control Overview y Partial-Page Rendering Overview.

El TreeView control se compone de nodos. Cada entrada del árbol se denomina nodo y está representado por un TreeNode objeto. Tipos de nodo se definen como sigue:

  • Un nodo que contiene otros nodos se denomina un nodo primario.

  • El nodo que está contenido en otro nodo se denomina un nodo secundario.

  • Un nodo que no tiene elementos secundarios se denomina un nodo hoja.

  • El nodo que no está incluido en ningún otro nodo pero es el antecesor de todos los demás nodos es el nodo raíz.

Un nodo puede ser un elemento primario y secundario, pero raíz, primario y nodos hoja son mutuamente excluyentes. Varias propiedades visuales y comportamiento de los nodos se determinan por si un nodo es raíz, secundario u hoja.

Aunque una estructura de árbol típica tiene sólo un nodo raíz, el TreeView control le permite agregar varios nodos raíz a la estructura de árbol. Esto es útil cuando desea mostrar listas de elementos sin mostrar un nodo raíz, como en una lista de categorías de producto.

Cada nodo tiene un Text propiedad y un Value propiedad. El valor de la Text propiedad se muestra en el TreeView, mientras que el Value propiedad se utiliza para almacenar datos adicionales sobre el nodo, como los datos que se pasan al evento de devolución de datos que está asociado con el nodo.

Un nodo puede estar en uno de dos modos: modo de selección y modo de exploración. De forma predeterminada, un nodo está en modo de selección. Para poner un nodo en modo de exploración, establezca la NavigateUrl propiedad del nodo en un valor distinto de una cadena vacía (""). Para poner un nodo en modo de selección, establezca el NavigateUrl propiedad del nodo en una cadena vacía ("").

System_CAPS_noteNota

Algunos exploradores de Internet tienen una limitación que puede afectar al rendimiento de la TreeView control. Por ejemplo, Microsoft Internet Explorer 6.0 tiene un límite de caracteres de la dirección URL de 2067 caracteres que envía. Si el número de caracteres en una dirección URL de un nodo es mayor que este número, se producirá un error al expandir ese nodo y se inicia ninguna excepción.

El modelo más sencillo de datos de la TreeView control es de datos estáticos. Para mostrar datos estáticos mediante sintaxis declarativa, primero anide de apertura y cierre <Nodes> etiquetas entre las etiquetas apertura y cierre de la TreeView control. A continuación, cree la estructura de árbol anidando <asp:TreeNode> elementos entre la apertura y cierre <Nodes> etiquetas. Cada <asp:TreeNode> elemento representa un nodo en el árbol y se asigna a un TreeNode objeto. Puede establecer las propiedades de cada nodo estableciendo los atributos de su <asp:TreeNode> elemento. Para crear nodos secundarios, anide adicionales <asp:TreeNode> elementos entre la apertura y cierre <asp:TreeNode> etiquetas del nodo primario.

El TreeView también se puede enlazar el control a los datos. Puede utilizar cualquiera de los dos métodos para enlazar el TreeView control para el tipo de origen de datos adecuado:

  • El TreeView control puede utilizar cualquier control de origen de datos que implementa el IHierarchicalDataSource de la interfaz, como un XmlDataSource control o un SiteMapDataSource control. Para enlazar a un control de origen de datos, establezca la DataSourceID propiedad de la TreeView el control a la ID el valor del control de origen de datos. El TreeView control se enlaza automáticamente al control de origen de datos especificado. Este es el método preferido para enlazar a datos.

  • El TreeView también se puede enlazar el control a un XmlDocument objeto o un DataSet objeto con las relaciones. Para enlazar a uno de estos orígenes de datos, establezca la DataSource propiedad de la TreeView control al origen de datos y, a continuación, llame a la DataBind (método).

Cuando se enlaza a un origen de datos donde cada elemento de datos contiene varias propiedades (como un elemento XML con varios atributos), un nodo muestra el valor devuelto por la ToString (método) del elemento de datos, de forma predeterminada. En el caso de un elemento XML, el nodo muestra el nombre del elemento, que muestra la estructura subyacente del árbol, pero no es muy útil en caso contrario. Puede enlazar un nodo a una propiedad de elemento de datos concreto especificando enlaces de nodo de árbol mediante el DataBindings colección. El DataBindings contiene la colección TreeNodeBinding objetos que definen la relación entre un elemento de datos y el nodo que se enlaza. Puede especificar los criterios de enlace y la propiedad del elemento de datos mostrar en el nodo. Para obtener más información sobre los enlaces de nodo de árbol, consulte TreeNodeBinding.

System_CAPS_security Seguridad Nota

Un usuario malintencionado puede crear una solicitud de devolución de llamada y obtener datos para los nodos de la TreeView control que el desarrollador de páginas no está mostrando. Por lo tanto, debe implementar la seguridad de los datos por el origen de datos. No utilice la MaxDataBindDepth propiedad para ocultar los datos.

A veces, no es práctico definir estáticamente la estructura de árbol porque el origen de datos devuelve demasiados datos o porque los datos para mostrar dependen de la información que se obtiene en tiempo de ejecución. Por este motivo, el TreeView control es compatible con el llenado de nodos dinámico. Cuando el PopulateOnDemand propiedad de un nodo se establece en true, ese nodo se rellena en tiempo de ejecución cuando se expande el nodo. Para rellenar dinámicamente un nodo, debe definir un método de control de eventos que contiene la lógica para rellenar un nodo para el TreeNodePopulate eventos.

Los exploradores que admiten scripts de devolución de llamada también pueden sacar partido del llenado de nodos en el cliente. (Esto incluye Internet Explorer 5.5 y posteriores y otros exploradores.) El llenado de nodos en el cliente permite la TreeView control para rellenar un nodo mediante script de cliente cuando los usuarios expandir el nodo, sin necesidad de ida y vuelta al servidor. Para obtener más información sobre el llenado de nodos en el cliente, consulte PopulateNodesFromClient.

Hay muchas maneras de personalizar la apariencia de la TreeView control. En primer lugar, puede especificar un estilo diferente (por ejemplo, el tamaño de fuente y color) para cada uno de los tipos de nodo.

Si utiliza hojas de estilos en cascada (CSS) para personalizar la apariencia del control, utilice estilos en línea o un archivo CSS independiente, pero no ambos. Uso de estilos en línea y un archivo CSS independiente puede producir resultados inesperados. Para obtener más información sobre el uso de hojas de estilos con controles, vea ASP.NET Web Server Controls and CSS Styles.

En la tabla siguiente se muestra los estilos de nodo disponible.

Propiedad de estilo de nodo

Descripción

HoverNodeStyle

La configuración de estilo de un nodo cuando el puntero del mouse se coloca sobre él.

LeafNodeStyle

La configuración de estilo para los nodos de hoja.

NodeStyle

La configuración de estilo predeterminada para un nodo.

ParentNodeStyle

La configuración de estilo para los nodos primarios.

RootNodeStyle

La configuración de estilo para el nodo raíz.

SelectedNodeStyle

La configuración de estilo para un nodo seleccionado.

También puede controlar el estilo de los nodos a profundidades concretas dentro del árbol mediante el LevelStyles colección. El primer estilo de la colección corresponde al estilo de los nodos del primer nivel en el árbol. El segundo estilo de la colección corresponde al estilo de los nodos en el segundo nivel en el árbol y así sucesivamente. Esto se suele utilizar frecuentemente para generar menús de navegación de contenido: estilo de donde los nodos de una cierta profundidad deberían tener el mismo aspecto, independientemente de si tienen nodos secundarios.

System_CAPS_noteNota

Si se define un estilo para un determinado profundidad nivel mediante el LevelStyles colección, que el estilo reemplaza cualquier raíz, primario o valores de estilo de nodo de hoja para los nodos a esa profundidad.

Otra manera de modificar el aspecto del control consiste en Personalizar las imágenes que se muestran en el TreeView control. Puede especificar su propio conjunto de imágenes para las diferentes partes del control personalizado estableciendo las propiedades mostradas en la tabla siguiente.

Propiedad de imagen

Descripción

CollapseImageUrl

La dirección URL a una imagen mostrada para el indicador de nodo contraíble. Esta imagen normalmente es un signo menos (-).

ExpandImageUrl

La dirección URL a una imagen mostrada para el indicador de nodo expansible. Esta imagen normalmente es un signo más (+).

LineImagesFolder

La dirección URL a la carpeta que contiene las imágenes de línea utilizadas para conectar los nodos primarios a los nodos secundarios. El ShowLines propiedad debe establecerse en true para esta propiedad tenga efecto.

NoExpandImageUrl

La dirección URL a una imagen mostrada para el indicador de nodo no expansible.

System_CAPS_noteNota

No es necesario personalizar todas las propiedades de imagen. Si no se establece explícitamente una propiedad de imagen, se utiliza la imagen predeterminada integrada.

El TreeView control también permite mostrar una casilla de verificación junto a un nodo. Cuando el ShowCheckBoxes propiedad se establece en un valor distinto de TreeNodeTypes.None, se muestran casillas junto a los tipos de nodo especificado.

System_CAPS_noteNota

El ShowCheckBoxes se puede establecer la propiedad en una combinación bit a bit de los TreeNodeTypes valores de miembro de enumeración.

Cada vez que la página se envía al servidor, el CheckedNodes colección se rellena automáticamente con los nodos seleccionados. Cuando se muestran casillas de verificación, puede utilizar el TreeNodeCheckChanged eventos para ejecutar una rutina personalizada cada vez que cambia el estado de una casilla de verificación entre envíos al servidor.

El TreeView control proporciona varios eventos que puede utilizar para programar. Esto le permite ejecutar una rutina personalizada siempre que se produce un evento. En la tabla siguiente se enumera los eventos admitidos por el TreeView control.

Evento

Descripción

TreeNodeCheckChanged

Se produce cuando las casillas de verificación de la TreeView control cambian entre cada envío al servidor.

SelectedNodeChanged

Se produce cuando se selecciona un nodo en el TreeView control.

TreeNodeExpanded

Se produce cuando se expande un nodo en el TreeView control.

TreeNodeCollapsed

Se produce cuando se contrae un nodo en el TreeView control.

TreeNodePopulate

Se produce cuando un nodo con su PopulateOnDemand propiedad establecida en true se expande en el TreeView control.

TreeNodeDataBound

Se produce cuando un elemento de datos se enlaza a un nodo en el TreeView control.

El TreeView control no tiene desplazamiento integrado. Para agregar el desplazamiento, coloque el TreeView del control de un Panel controlar y agregar barras de desplazamiento a la Panel control. Para obtener más información, consulta Panel Web Server Control Overview.

El marcado que se representa de forma predeterminada para este control no podría cumplir los estándares de accesibilidad. Para obtener más información sobre la compatibilidad de accesibilidad para este control, consulte ASP.NET Controls and Accessibility.

<asp:TreeView
    AccessKey="string"
    AutoGenerateDataBindings="True|False"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CollapseImageToolTip="string"
    CollapseImageUrl="uri"
    CssClass="string"
    DataSource="string"
    DataSourceID="string"
    EnableClientScript="True|False"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    ExpandDepth="string|FullyExpand|0|1|2|3|4|5|6|7|8|9|10|11|12|13|
        14|15|16|17|18|19|20|21|22|23|24|25|26|27|28|29|30"
    ExpandImageToolTip="string"
    ExpandImageUrl="uri"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
       Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    ImageSet="Custom|XPFileExplorer|Msdn|WindowsHelp|Simple|Simple2|
        BulletedList|BulletedList2|BulletedList3|BulletedList4|
        Arrows|News|Contacts|Inbox|Events|Faq"
    LineImagesFolder="string"
    MaxDataBindDepth="integer"
    NodeIndent="integer"
    NodeWrap="True|False"
    NoExpandImageUrl="uri"
    OnDataBinding="DataBinding event handler"
    OnDataBound="DataBound event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnSelectedNodeChanged="SelectedNodeChanged event handler"
    OnTreeNodeCheckChanged="TreeNodeCheckChanged event handler"
    OnTreeNodeCollapsed="TreeNodeCollapsed event handler"
    OnTreeNodeDataBound="TreeNodeDataBound event handler"
    OnTreeNodeExpanded="TreeNodeExpanded event handler"
    OnTreeNodePopulate="TreeNodePopulate event handler"
    OnUnload="Unload event handler"
    PathSeparator="string"
    PopulateNodesFromClient="True|False"
    runat="server"
    ShowCheckBoxes="None|Root|Parent|Leaf|All"
    ShowExpandCollapse="True|False"
    ShowLines="True|False"
    SkinID="string"
    SkipLinkText="string"
    Style="string"
    TabIndex="integer"
    Target="string"
    ToolTip="string"
    Visible="True|False"
    Width="size"
>
        <DataBindings>
                <asp:TreeNodeBinding
                    DataMember="string"
                    Depth="integer"
                    FormatString="string"
                    ImageToolTip="string"
                    ImageToolTipField="string"
                    ImageUrl="uri"
                    ImageUrlField="string"
                    NavigateUrl="uri"
                    NavigateUrlField="string"
                    PopulateOnDemand="True|False"
                    SelectAction="Select|Expand|SelectExpand|None"
                    ShowCheckBox="string"
                    Target="string"
                    TargetField="string"
                    Text="string"
                    TextField="string"
                    ToolTip="string"
                    ToolTipField="string"
                    Value="string"
                    ValueField="string"
                />
        </DataBindings>
        <HoverNodeStyle />
        <LeafNodeStyle
            BackColor="color name|#dddddd"
            BorderColor="color name|#dddddd"
            BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|
                Groove|Ridge|Inset|Outset"
            BorderWidth="size"
            ChildNodesPadding="size"
            CssClass="string"
            Font-Bold="True|False"
            Font-Italic="True|False"
            Font-Names="string"
            Font-Overline="True|False"
            Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|
                Medium|Large|X-Large|XX-Large"
            Font-Strikeout="True|False"
            Font-Underline="True|False"
            ForeColor="color name|#dddddd"
            Height="size"
            HorizontalPadding="size"
            ImageUrl="uri"
            NodeSpacing="size"
            OnDisposed="Disposed event handler"
            VerticalPadding="size"
            Width="size"
        />
        <LevelStyles>
                <asp:TreeNodeStyle
                    BackColor="color name|#dddddd"
                    BorderColor="color name|#dddddd"
                    BorderStyle="NotSet|None|Dotted|Dashed|Solid|
                        Double|Groove|Ridge|Inset|Outset"
                    BorderWidth="size"
                    ChildNodesPadding="size"
                    CssClass="string"
                    Font-Bold="True|False"
                    Font-Italic="True|False"
                    Font-Names="string"
                    Font-Overline="True|False"
                    Font-Size="string|Smaller|Larger|XX-Small|
                        X-Small|Small|Medium|Large|X-Large|XX-Large"
                    Font-Strikeout="True|False"
                    Font-Underline="True|False"
                    ForeColor="color name|#dddddd"
                    Height="size"
                    HorizontalPadding="size"
                    ImageUrl="uri"
                    NodeSpacing="size"
                    OnDisposed="Disposed event handler"
                    VerticalPadding="size"
                    Width="size"
                />
        </LevelStyles>
        <Nodes>
                <asp:TreeNode
                    Checked="True|False"
                    Expanded="string"
                    ImageToolTip="string"
                    ImageUrl="uri"
                    NavigateUrl="uri"
                    PopulateOnDemand="True|False"
                    SelectAction="Select|Expand|SelectExpand|None"
                    Selected="True|False"
                    ShowCheckBox="string"
                    Target="string"
                    Text="string"
                    ToolTip="string"
                    Value="string"
>
                </asp:TreeNode>
        </Nodes>
        <NodeStyle
            BackColor="color name|#dddddd"
            BorderColor="color name|#dddddd"
            BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|
                Groove|Ridge|Inset|Outset"
            BorderWidth="size"
            ChildNodesPadding="size"
            CssClass="string"
            Font-Bold="True|False"
            Font-Italic="True|False"
            Font-Names="string"
            Font-Overline="True|False"
            Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|
                Medium|Large|X-Large|XX-Large"
            Font-Strikeout="True|False"
            Font-Underline="True|False"
            ForeColor="color name|#dddddd"
            Height="size"
            HorizontalPadding="size"
            ImageUrl="uri"
            NodeSpacing="size"
            OnDisposed="Disposed event handler"
            VerticalPadding="size"
            Width="size"
        />
        <ParentNodeStyle
            BackColor="color name|#dddddd"
            BorderColor="color name|#dddddd"
            BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|
                Groove|Ridge|Inset|Outset"
            BorderWidth="size"
            ChildNodesPadding="size"
            CssClass="string"
            Font-Bold="True|False"
            Font-Italic="True|False"
            Font-Names="string"
            Font-Overline="True|False"
            Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|
                Medium|Large|X-Large|XX-Large"
            Font-Strikeout="True|False"
            Font-Underline="True|False"
            ForeColor="color name|#dddddd"
            Height="size"
            HorizontalPadding="size"
            ImageUrl="uri"
            NodeSpacing="size"
            OnDisposed="Disposed event handler"
            VerticalPadding="size"
            Width="size"
        />
        <RootNodeStyle
            BackColor="color name|#dddddd"
            BorderColor="color name|#dddddd"
            BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|
                Groove|Ridge|Inset|Outset"
            BorderWidth="size"
            ChildNodesPadding="size"
            CssClass="string"
            Font-Bold="True|False"
            Font-Italic="True|False"
            Font-Names="string"
            Font-Overline="True|False"
            Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|
                Medium|Large|X-Large|XX-Large"
            Font-Strikeout="True|False"
            Font-Underline="True|False"
            ForeColor="color name|#dddddd"
            Height="size"
            HorizontalPadding="size"
            ImageUrl="uri"
            NodeSpacing="size"
            OnDisposed="Disposed event handler"
            VerticalPadding="size"
            Width="size"
        />
        <SelectedNodeStyle
            BackColor="color name|#dddddd"
            BorderColor="color name|#dddddd"
            BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|
                Groove|Ridge|Inset|Outset"
            BorderWidth="size"
            ChildNodesPadding="size"
            CssClass="string"
            Font-Bold="True|False"
            Font-Italic="True|False"
            Font-Names="string"
            Font-Overline="True|False"
            Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|
                Medium|Large|X-Large|XX-Large"
            Font-Strikeout="True|False"
            Font-Underline="True|False"
            ForeColor="color name|#dddddd"
            Height="size"
            HorizontalPadding="size"
            ImageUrl="uri"
            NodeSpacing="size"
            OnDisposed="Disposed event handler"
            VerticalPadding="size"
            Width="size"
        />
</asp:TreeView>

Esta sección contiene siete ejemplos de código:

  • El primer ejemplo de código muestra cómo configurar los marcos para el segundo ejemplo de código.

  • El segundo ejemplo de código muestra cómo utilizar la sintaxis declarativa para mostrar datos estáticos en el TreeView control.

  • El tercer ejemplo de código muestra cómo enlazar el TreeView control a un origen de datos XML.

  • El cuarto ejemplo de código proporciona datos XML de ejemplo para el tercer ejemplo de código.

  • El quinto ejemplo de código muestra cómo utilizar el TreeView control de navegación del sitio mediante el enlace a un SiteMapDataSource control.

  • El sexto ejemplo de código proporciona datos de mapa del sitio de ejemplo para el quinto ejemplo de código.

  • El séptimo ejemplo de código muestra cómo rellenar los nodos en el TreeView control desde el cliente.

En el ejemplo de código siguiente se muestra cómo configurar los marcos para el ejemplo de código siguiente.


<html xmlns="http://www.w3.org/1999/xhtml">
<head>
    <title>TreeView Frameset Example</title>
</head>

    <frameset cols="30%, 75%">

        <frame title="MenuFrame" name="Menu" src="TreeViewFramecs.aspx"/>
        <frame title="ContentFrame" name="Content" src="Home.aspx"/> 

    </frameset>      

</html>

En el ejemplo de código siguiente se muestra cómo utilizar la sintaxis declarativa para mostrar datos estáticos en el TreeView control. En este ejemplo se utiliza dentro del conjunto de marco del ejemplo anterior para mostrar una tabla de contenido.


<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>TreeView Declarative Syntax Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>TreeView Declarative Syntax Example</h3>

      <asp:TreeView id="SampleTreeView" 
        runat="server">

        <Nodes>

          <asp:TreeNode Value="Home" 
            NavigateUrl="Home.aspx" 
            Text="Home"
            Target="Content" 
            Expanded="True">

            <asp:TreeNode Value="Page 1" 
              NavigateUrl="Page1.aspx" 
              Text="Page1"
              Target="Content">

              <asp:TreeNode Value="Section 1" 
                NavigateUrl="Section1.aspx" 
                Text="Section 1"
                Target="Content"/>

            </asp:TreeNode>              

            <asp:TreeNode Value="Page 2" 
              NavigateUrl="Page2.aspx"
              Text="Page 2"
              Target="Content">

            </asp:TreeNode> 

          </asp:TreeNode>

        </Nodes>

      </asp:TreeView>

    </form>
  </body>
</html>

En el ejemplo de código siguiente se muestra cómo enlazar el TreeView control a un origen de datos XML. En 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">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>TreeView XML Data Binding Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>TreeView XML Data Binding Example</h3>

      <asp:TreeView id="BookTreeView" 
        DataSourceID="BookXmlDataSource"
        runat="server">

        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" TextField="Title"/>
          <asp:TreeNodeBinding DataMember="Chapter" TextField="Heading"/>
          <asp:TreeNodeBinding DataMember="Section" TextField="Heading"/>
        </DataBindings>

      </asp:TreeView>

      <asp:XmlDataSource id="BookXmlDataSource"  
        DataFile="Book.xml"
        runat="server">
      </asp:XmlDataSource>

    </form>
  </body>
</html>

El ejemplo de código siguiente proporciona datos XML de ejemplo para el ejemplo 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>
</Book>

En el ejemplo de código siguiente se muestra cómo utilizar el TreeView control de navegación del sitio mediante el enlace a un SiteMapDataSource control. En este ejemplo funcione correctamente, debe copiar los datos de mapa del sitio de ejemplo, proporcionados después de este ejemplo de código en un archivo denominado Web.sitemap.


<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>TreeView AutoGenerateBindings Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>TreeView AutoGenerateBindings Example</h3>

      <!-- Set the AutoGenerateBindings property -->
      <!-- to false declaratively to allow for   -->
      <!-- the user-defined Bindings collection. -->
      <asp:TreeView id="SiteTreeView" 
        DataSourceID="SiteMapSource"
        AutoGenerateDataBindings="False"
        runat="server">

        <DataBindings>

          <asp:TreeNodeBinding TextField="title" NavigateUrlField="url"/>

        </DataBindings>

      </asp:TreeView>

      <asp:SiteMapDataSource ID="SiteMapSource" runat="server"/>

    </form>
  </body>
</html>

El siguiente ejemplo de código proporciona datos de mapa del sitio de ejemplo para el ejemplo de código anterior.

<siteMap>
    <siteMapNode title="Home" description="Home" url="default.aspx">
        <siteMapNode title="Products" description="Products" url="Products.aspx">
            <siteMapNode title="Computers" url="Computers.aspx"/>
            <siteMapNode title="Accessories" url="Accessories.aspx"/>     
        </siteMapNode>
    </siteMapNode>
</siteMap>

En el ejemplo de código siguiente se muestra cómo rellenar los nodos en el TreeView control desde el cliente. Cuando se habilita el relleno de nodos del lado cliente, los nodos se rellenan dinámicamente en el cliente, sin necesidad de registrar el servidor.


<%@ Page Language="C#" %>
<%@ Import Namespace="System.Data" %>
<%@ Import Namespace="System.Data.SqlClient" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void PopulateNode(Object sender, TreeNodeEventArgs e)
  {

    // Call the appropriate method to populate a node at a particular level.
    switch(e.Node.Depth)
    {
      case 0:
        // Populate the first-level nodes.
        PopulateCategories(e.Node);
        break;
      case 1:
        // Populate the second-level nodes.
        PopulateProducts(e.Node);
        break;
      default:
        // Do nothing.
        break;
    }

  }

  void PopulateCategories(TreeNode node)
  {

    // Query for the product categories. These are the values
    // for the second-level nodes.
    DataSet ResultSet = RunQuery("Select CategoryID, CategoryName From Categories");

    // Create the second-level nodes.
    if(ResultSet.Tables.Count > 0)
    {

      // Iterate through and create a new node for each row in the query results.
      // Notice that the query results are stored in the table of the DataSet.
      foreach (DataRow row in ResultSet.Tables[0].Rows)
      {

        // Create the new node. Notice that the CategoryId is stored in the Value property 
        // of the node. This will make querying for items in a specific category easier when
        // the third-level nodes are created. 
        TreeNode newNode = new TreeNode();
        newNode.Text = row["CategoryName"].ToString(); 
        newNode.Value = row["CategoryID"].ToString();        

        // Set the PopulateOnDemand property to true so that the child nodes can be 
        // dynamically populated.
        newNode.PopulateOnDemand = true;

        // Set additional properties for the node.
        newNode.SelectAction = TreeNodeSelectAction.Expand;

        // Add the new node to the ChildNodes collection of the parent node.
        node.ChildNodes.Add(newNode);

      }

    }

  }

  void PopulateProducts(TreeNode node)
  {

    // Query for the products of the current category. These are the values
    // for the third-level nodes.
    DataSet ResultSet = RunQuery("Select ProductName From Products Where CategoryID=" + node.Value);

    // Create the third-level nodes.
    if(ResultSet.Tables.Count > 0)
    {

      // Iterate through and create a new node for each row in the query results.
      // Notice that the query results are stored in the table of the DataSet.
      foreach (DataRow row in ResultSet.Tables[0].Rows)
      {

        // Create the new node.
        TreeNode NewNode = new TreeNode(row["ProductName"].ToString());

        // Set the PopulateOnDemand property to false, because these are leaf nodes and
        // do not need to be populated.
        NewNode.PopulateOnDemand = false;

        // Set additional properties for the node.
        NewNode.SelectAction = TreeNodeSelectAction.None;

        // Add the new node to the ChildNodes collection of the parent node.
        node.ChildNodes.Add(NewNode);

      }

    }

  }

  DataSet RunQuery(String QueryString)
  {

    // Declare the connection string. This example uses Microsoft SQL Server 
    // and connects to the Northwind sample database.
    String ConnectionString = "server=localhost;database=NorthWind;Integrated Security=SSPI"; 

    SqlConnection DBConnection = new SqlConnection(ConnectionString);
    SqlDataAdapter DBAdapter;
    DataSet ResultsDataSet = new DataSet();

    try
    {

      // Run the query and create a DataSet.
      DBAdapter = new SqlDataAdapter(QueryString, DBConnection);
      DBAdapter.Fill(ResultsDataSet);

      // Close the database connection.
      DBConnection.Close();

    }
    catch(Exception ex)
    {

      // Close the database connection if it is still open.
      if(DBConnection.State == ConnectionState.Open)
      {
        DBConnection.Close();
      }

      Message.Text = "Unable to connect to the database.";

    }

    return ResultsDataSet;

  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>TreeView PopulateNodesFromClient Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>TreeView PopulateNodesFromClient Example</h3>

      <asp:TreeView id="LinksTreeView"
        Font-Names= "Arial"
        ForeColor="Blue"
        EnableClientScript="true"
        PopulateNodesFromClient="true"  
        OnTreeNodePopulate="PopulateNode"
        runat="server">

        <Nodes>

          <asp:TreeNode Text="Inventory" 
            SelectAction="Expand"  
            PopulateOnDemand="true"/>

        </Nodes>

      </asp:TreeView>

      <br /><br />

      <asp:Label id="Message" runat="server"/>

    </form>
  </body>
</html>

.NET Framework
Disponible desde 2.0

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: