Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

TreeView (Clase)

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
<asp:TreeView />

El tipo TreeView expone los siguientes miembros.

  NombreDescripción
Método públicoTreeViewInicializa una nueva instancia de la clase TreeView.
Arriba

  NombreDescripción
Propiedad públicaAccessKeyObtiene o establece la clave de acceso que permite navegar rápidamente al control de servidor web. (Se hereda de WebControl).
Propiedad protegidaAdapterObtiene el adaptador específico del explorador para el control. (Se hereda de Control).
Propiedad públicaAppRelativeTemplateSourceDirectoryObtiene o establece el directorio virtual relativo a la aplicación del objeto Page o el objeto UserControl que contiene este control. (Se hereda de Control).
Propiedad públicaAttributesObtiene la colección de atributos arbitrarios (sólo para su representación) que no corresponden a propiedades del control. (Se hereda de WebControl).
Propiedad públicaAutoGenerateDataBindingsObtiene o establece un valor que indica si el control TreeView genera automáticamente los enlaces del nodo de árbol.
Propiedad públicaBackColorObtiene o establece el color de fondo del control de servidor web. (Se hereda de WebControl).
Propiedad públicaBindingContainerInfraestructura. Obtiene el control que contiene el enlace de datos de este control. (Se hereda de Control).
Propiedad públicaBorderColorObtiene o establece el color de borde del control Web. (Se hereda de WebControl).
Propiedad públicaBorderStyleObtiene o establece el estilo del borde del control de servidor web. (Se hereda de WebControl).
Propiedad públicaBorderWidthObtiene o establece el ancho del borde del control de servidor web. (Se hereda de WebControl).
Propiedad públicaCheckedNodesObtiene una colección de objetos TreeNode que representan los nodos del control TreeView que muestra una casilla activada.
Propiedad protegidaChildControlsCreatedObtiene un valor que indica si se han creado controles secundarios del control de servidor. (Se hereda de Control).
Propiedad públicaClientIDObtiene el identificador de control del formato HTML generado por ASP.NET. (Se hereda de Control).
Propiedad públicaClientIDModeObtiene o establece el algoritmo que se utiliza para generar el valor de la propiedad ClientID. (Se hereda de Control).
Propiedad protegidaClientIDSeparatorObtiene un valor de carácter que representa el carácter separado utilizado en la propiedad ClientID. (Se hereda de Control).
Propiedad públicaCollapseImageToolTipObtiene o establece la información sobre herramientas para la imagen que se muestra para el indicador de nodo contraíble.
Propiedad públicaCollapseImageUrlObtiene o establece la dirección URL a una imagen personalizada para el indicador de nodo contraíble.
Propiedad protegidaContextObtiene el objeto HttpContext asociado al control de servidor para la solicitud Web actual. (Se hereda de Control).
Propiedad públicaControlsObtiene un objeto ControlCollection que representa los controles secundarios para un control de servidor especificado en la jerarquía de la interfaz de usuario. (Se hereda de Control).
Propiedad públicaControlStyleObtiene el estilo del control de servidor web. Esta propiedad la usan principalmente los programadores de controles. (Se hereda de WebControl).
Propiedad públicaControlStyleCreatedObtiene un valor que indica si se ha creado un objeto Style para la propiedad ControlStyle. Esta propiedad la usan principalmente los programadores de controles. (Se hereda de WebControl).
Propiedad públicaCssClassObtiene o establece la clase hoja de estilos en cascada (CSS) presentada por el control de servidor web en el cliente. (Se hereda de WebControl).
Propiedad públicaDataBindingsObtiene una colección de objetos TreeNodeBinding que definen la relación entre un elemento de datos y el nodo al que se enlaza.
Propiedad públicaDataItemContainerObtiene una referencia al contenedor de nomenclatura si este implementa IDataItemContainer. (Se hereda de Control).
Propiedad públicaDataKeysContainerObtiene una referencia al contenedor de nomenclatura si este implementa IDataKeysControl. (Se hereda de Control).
Propiedad públicaDataSourceObtiene o establece el objeto del que el control enlazado a datos recupera su lista de elementos de datos. (Se hereda de BaseDataBoundControl).
Propiedad públicaDataSourceIDObtiene o establece el Id. del control del cual el control enlazado a datos recupera su lista de elementos de datos. (Se hereda de HierarchicalDataBoundControl).
Propiedad protegidaDesignModeObtiene un valor que indica si se está utilizando un control en una superficie de diseño. (Se hereda de Control).
Propiedad públicaEnableClientScriptObtiene o establece un valor que indica si el control TreeView representa script de cliente para controlar los eventos de expansión y contracción.
Propiedad públicaEnabledObtiene o establece un valor que indica si el control de servidor web está habilitado. (Se hereda de WebControl).
Propiedad públicaEnableThemingObtiene o establece un valor que indica si los temas se aplican a este control. (Se hereda de WebControl).
Propiedad públicaEnableViewStateObtiene o establece un valor que indica si el control de servidor debe mantener su estado de vista y el de los controles secundarios que contiene, en el cliente que realiza la solicitud. (Se hereda de Control).
Propiedad protegidaEventsObtiene una lista de delegados de controladores de eventos del control. Esta propiedad es de sólo lectura. (Se hereda de Control).
Propiedad públicaExpandDepthObtiene o establece el número de niveles que se expanden cuando se muestra un control TreeView por primera vez.
Propiedad públicaExpandImageToolTipObtiene o establece la información sobre herramientas para la imagen que se muestra para el indicador de nodo expansible.
Propiedad públicaExpandImageUrlObtiene o establece la dirección URL a una imagen personalizada para el indicador de nodo expansible.
Propiedad públicaFontObtiene las propiedades de fuente asociadas al control de servidor web. (Se hereda de WebControl).
Propiedad públicaForeColorObtiene o establece el color de primer plano (normalmente el color del texto) del control de servidor web. (Se hereda de WebControl).
Propiedad públicaHasAttributesObtiene un valor que indica si el control tiene establecido algún atributo. (Se hereda de WebControl).
Propiedad protegidaHasChildViewStateObtiene un valor que indica si los controles secundarios del control de servidor actual tienen guardada alguna configuración del estado de vista. (Se hereda de Control).
Propiedad públicaHeightObtiene o establece el alto del control de servidor Web. (Se hereda de WebControl).
Propiedad públicaHoverNodeStyleObtiene una referencia al objeto TreeNodeStyle que permite establecer el aspecto de un nodo cuando el puntero del mouse se coloca sobre él.
Propiedad públicaIDObtiene o establece el identificador de programación asignado al control de servidor. (Se hereda de Control).
Propiedad protegidaIdSeparatorInfraestructura. Obtiene el carácter utilizado para separar los identificadores de control. (Se hereda de Control).
Propiedad públicaImageSetObtiene o establece el grupo de imágenes a utilizar para el control TreeView.
Propiedad protegidaInitializedObtiene un valor que indica si el control enlazado a datos está inicializado. (Se hereda de BaseDataBoundControl).
Propiedad protegidaIsBoundUsingDataSourceIDObtiene un valor que indica si la propiedad DataSourceID está establecida. (Se hereda de BaseDataBoundControl).
Propiedad protegidaIsChildControlStateClearedObtiene un valor que indica si los controles que se encuentran en este control tienen estado de control. (Se hereda de Control).
Propiedad protegidaIsDataBindingAutomaticObtiene un valor que indica el enlace a datos es automático. (Se hereda de BaseDataBoundControl).
Propiedad protegidaIsEnabledObtiene un valor que indica si está habilitado el control. (Se hereda de WebControl).
Propiedad protegidaIsTrackingViewStateObtiene un valor que indica si el control de servidor está guardando los cambios realizados en su estado de vista. (Se hereda de Control).
Propiedad protegidaIsUsingModelBindersCuando se implementa en una clase derivada, obtiene un valor que indica si el control está usando enlazadores de modelos. (Se hereda de BaseDataBoundControl).
Propiedad protegidaIsViewStateEnabledObtiene un valor que indica si el estado de vista está habilitado para este control. (Se hereda de Control).
Propiedad públicaLeafNodeStyleObtiene una referencia al objeto TreeNodeStyle que permite establecer el aspecto de los nodos de hoja.
Propiedad públicaLevelStylesObtiene una colección de objetos Style que representan estilos de nodo en los niveles individuales del árbol.
Propiedad públicaLineImagesFolderObtiene o establece la ruta de acceso a una carpeta que contiene las imágenes de la línea que se utilizan para conectar los nodos secundarios a los nodos primarios.
Propiedad protegidaLoadViewStateByIDObtiene un valor que indica si el control participa en la carga de su estado de vista mediante ID en lugar de índice. (Se hereda de Control).
Propiedad públicaMaxDataBindDepthObtiene o establece el número máximo de niveles del árbol a enlazar al control TreeView.
Propiedad públicaNamingContainerObtiene una referencia al contenedor de nomenclatura del control de servidor, que crea un espacio de nombres único para diferenciar los distintos controles de servidor que tienen el mismo valor para la propiedad Control.ID. (Se hereda de Control).
Propiedad públicaNodeIndentObtiene o establece la cantidad de sangría (en píxeles) para los nodos secundarios del control TreeView.
Propiedad públicaNodesObtiene una colección de objetos TreeNode que representa los nodos raíz del control TreeView.
Propiedad públicaNodeStyleObtiene una referencia al objeto TreeNodeStyle que permite establecer la apariencia predeterminada de los nodos del control TreeView.
Propiedad públicaNodeWrapObtiene o establece un valor que indica si el texto se ajusta en un nodo cuando el nodo se queda sin espacio.
Propiedad públicaNoExpandImageUrlObtiene o establece la dirección URL a una imagen personalizada para el indicador de nodo no expansible.
Propiedad públicaPageObtiene una referencia a la instancia Page que contiene el control de servidor. (Se hereda de Control).
Propiedad públicaParentObtiene una referencia al control principal del control de servidor en la jerarquía de controles de página. (Se hereda de Control).
Propiedad públicaParentNodeStyleObtiene una referencia al objeto TreeNodeStyle que permite establecer la apariencia de los nodos primarios del control TreeView.
Propiedad públicaPathSeparatorObtiene o establece el carácter que se utiliza para delimitar los valores de nodo especificados por la propiedad ValuePath.
Propiedad públicaPopulateNodesFromClientObtiene o establece un valor que indica si los datos de nodo se rellenan a demanda del cliente.
Propiedad públicaRenderingCompatibilityObtiene o establece un valor que especifica la versión de ASP.NET compatible con los elementos HTML representados. (Se hereda de Control).
Propiedad protegidaRequiresDataBindingObtiene o establece un valor que indica si se debe llamar al método DataBind. (Se hereda de BaseDataBoundControl).
Propiedad públicaRootNodeStyleObtiene una referencia al objeto TreeNodeStyle que permite establecer la apariencia del nodo raíz del control TreeView.
Propiedad públicaSelectedNodeObtiene un objeto TreeNode que representa el nodo seleccionado del control TreeView.
Propiedad públicaSelectedNodeStyleObtiene el objeto TreeNodeStyle que controla el aspecto del nodo seleccionado en el control TreeView.
Propiedad públicaSelectedValueObtiene el valor del nodo seleccionado.
Propiedad públicaShowCheckBoxesObtiene o establece un valor que indica qué tipos de nodo mostrarán una casilla en el control TreeView.
Propiedad públicaShowExpandCollapseObtiene o establece un valor que indica si se muestran los indicadores de nodo de expansión.
Propiedad públicaShowLinesObtiene o establece un valor que indica se muestran si las líneas que conectan los nodos secundarios a los nodos primarios.
Propiedad públicaSiteObtiene información sobre el contenedor en que se encuentra el control actual cuando se representa en una superficie de diseño. (Se hereda de Control).
Propiedad públicaSkinIDObtiene o establece la máscara que se va a aplicar al control. (Se hereda de WebControl).
Propiedad públicaSkipLinkTextObtiene o establece un valor que se utiliza para representar texto alternativo para que los lectores de pantalla omitan el contenido del control.
Propiedad públicaStyleObtiene una colección de atributos de texto que se representan como atributo de estilo en la etiqueta externa del control de servidor web. (Se hereda de WebControl).
Propiedad públicaSupportsDisabledAttributeObtiene un valor que indica si el control debe establecer en "disabled" el atributo disabled del elemento HTML presentado cuando el valor de la propiedad IsEnabled del control es false. (Se hereda de BaseDataBoundControl).
Propiedad públicaTabIndexObtiene o establece el índice de tabulación del control de servidor web. (Se hereda de WebControl).
Propiedad protegidaTagKeyObtiene el valor de System.Web.UI.HtmlTextWriterTag para el control TreeView. (Invalida a WebControl.TagKey).
Propiedad protegidaTagNameObtiene el nombre de la etiqueta del control. Esta propiedad la usan principalmente los programadores de controles. (Se hereda de WebControl).
Propiedad públicaTargetObtiene o establece la ventana o el marco de destino donde se mostrará el contenido de una página Web asociada a un nodo.
Propiedad públicaTemplateControlObtiene o establece una referencia a la plantilla que contiene este control. (Se hereda de Control).
Propiedad públicaTemplateSourceDirectoryObtiene el directorio virtual de Page o UserControl que contiene el control de servidor actual. (Se hereda de Control).
Propiedad públicaToolTipObtiene o establece el texto que se muestra cuando el puntero del mouse se desplaza sobre el control de servidor web. (Se hereda de WebControl).
Propiedad públicaUniqueIDObtiene el identificador único calificado jerárquicamente para el control de servidor. (Se hereda de Control).
Propiedad públicaValidateRequestModeObtiene o establece un valor que indica si el control comprueba la entrada del cliente desde el explorador para valores potencialmente peligrosos. (Se hereda de Control).
Propiedad protegidaViewStateObtiene un diccionario con información de estado que le permite guardar y restaurar el estado de vista de un control de servidor en las distintas solicitudes de la misma página. (Se hereda de Control).
Propiedad protegidaViewStateIgnoresCaseObtiene un valor que indica si el objeto StateBag no distingue mayúsculas de minúsculas. (Se hereda de Control).
Propiedad públicaViewStateModeObtiene o establece el modo del estado de vista de este control. (Se hereda de Control).
Propiedad públicaVisibleObtiene o establece un valor que indica si el control se debe representar como interfaz de usuario en la página. (Invalida a Control.Visible).
Propiedad públicaWidthObtiene o establece el ancho del control de servidor web. (Se hereda de WebControl).
Arriba

  NombreDescripción
Método protegidoAddAttributesToRenderAgrega atributos y estilos HTML que se deben representar en el control HtmlTextWriter especificado. (Invalida a WebControl.AddAttributesToRender(HtmlTextWriter)).
Método protegidoAddedControlSe le llama una vez que se ha agregado un control secundario a la colección Controls del Control objeto. (Se hereda de Control).
Método protegidoAddParsedSubObjectIndica al control de servidor que se ha analizado un elemento, ya sea XML o HTML, y agrega dicho elemento al objeto ControlCollection del control de servidor. (Se hereda de Control).
Método públicoApplyStyleCopia en el control Web todos los elementos no vacíos del estilo especificado, sobrescribiendo los elementos de estilo existentes del mismo. Este método lo usan principalmente los programadores de controles. (Se hereda de WebControl).
Método públicoApplyStyleSheetSkinAplica al control las propiedades de estilo definidas en la hoja de estilos de la página. (Se hereda de Control).
Método protegidoBeginRenderTracingComienza el seguimiento en tiempo de diseño de los datos de representación. (Se hereda de Control).
Método protegidoBuildProfileTreeInfraestructura. Recopila información sobre el control de servidor y la pasa a la propiedad Trace para que se muestre cuando está habilitada la traza de la página. (Se hereda de Control).
Método protegidoClearCachedClientIDInfraestructura. Establece en null el valor de ClientID almacenado en caché. (Se hereda de Control).
Método protegidoClearChildControlStateElimina la información sobre el estado de control de los controles secundarios del control de servidor. (Se hereda de Control).
Método protegidoClearChildStateElimina la información sobre el estado de vista y el estado de control de los controles secundarios del control de servidor. (Se hereda de Control).
Método protegidoClearChildViewStateElimina la información sobre el estado de vista de todos los controles secundarios del control de servidor. (Se hereda de Control).
Método protegidoClearEffectiveClientIDModeInfraestructura. Establece la propiedad ClientIDMode de la instancia del control actual y de cualquier control secundario en Inherit. (Se hereda de Control).
Método públicoCollapseAllCierra cada nodo en el árbol.
Método protegidoConfirmInitStateEstablece el estado inicializado del control enlazado a datos. (Se hereda de BaseDataBoundControl).
Método públicoCopyBaseAttributesCopia las propiedades no encapsuladas por el objeto Style del control de servidor web especificado al control de servidor web desde el que se efectúa la llamada al método. Este método lo usan principalmente los desarrolladores de controles. (Se hereda de WebControl).
Método protegidoCreateChildControlsLo llama el marco de trabajo de las páginas ASP.NET para indicar a los controles de servidor que utilizan la implementación basada en la composición que creen los controles secundarios que contengan como forma de preparar la devolución o representación de los datos. (Se hereda de Control).
Método protegidoCreateControlCollectionCrea una colección para almacenar controles secundarios. (Invalida a Control.CreateControlCollection()).
Método protegidoCreateControlStyleCrea el objeto de estilo que utiliza la clase WebControl de forma interna para implementar todas las propiedades relacionadas con el estilo. Este método lo usan principalmente los desarrolladores de controles. (Se hereda de WebControl).
Método protegidoCreateNodeInfraestructura. Devuelve una nueva instancia de la clase TreeNode. El método CreateNode es un método auxiliar.
Método públicoDataBind()Llama al método DataBind de la clase base. (Invalida a BaseDataBoundControl.DataBind()).
Método protegidoDataBind(Boolean)Enlaza un origen de datos al control de servidor que se ha invocado y a todos sus controles secundarios con una opción para generar el evento DataBinding. (Se hereda de Control).
Método protegidoDataBindChildrenEnlaza un origen de datos a los controles secundarios del control de servidor. (Se hereda de Control).
Método públicoDisposeHabilita un control de servidor para que realice la limpieza final antes de que se libere de la memoria. (Se hereda de Control).
Método protegidoEndRenderTracingFinaliza el seguimiento en tiempo de diseño de los datos de representación. (Se hereda de Control).
Método protegidoEnsureChildControlsDetermina si el control de servidor contiene controles secundarios. Si no tiene controles secundarios, los crea. (Se hereda de Control).
Método protegidoEnsureDataBoundLlama al método DataBind si se establece la propiedad DataSourceID y el control enlazado a datos está marcado de forma que requiera el enlace. (Se hereda de BaseDataBoundControl).
Método protegidoEnsureIDCrea un identificador para controles que no tiene un identificador asignado. (Se hereda de Control).
Método públicoEquals(Object)Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método públicoExpandAllAbre cada nodo del árbol.
Método protegidoFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método públicoFindControl(String)Busca un control de servidor con el parámetro id especificado en el contenedor de nomenclatura actual. (Se hereda de Control).
Método protegidoFindControl(String, Int32)Infraestructura. Busca el contenedor de nomenclatura actual para un control de servidor con el id especificado y un entero, que se especifica en el parámetro pathOffset, que ayuda a realizar la búsqueda. Esta versión del método FindControl no se debe reemplazar. (Se hereda de Control).
Método públicoFindNodeRecupera el objeto TreeNode del control TreeView en la ruta de acceso del valor especificado.
Método públicoFocusEstablece el foco de entrada en un control. (Se hereda de Control).
Método protegidoGetCallbackResultDevuelve el resultado de un evento de devolución de llamada que tiene como destino un control.
Método protegidoGetDataRecupera un objeto HierarchicalDataSourceView que el control enlazado a datos usa para llevar a cabo operaciones de datos. (Se hereda de HierarchicalDataBoundControl).
Método protegidoGetDataSourceRecupera la interfaz IHierarchicalDataSource a la que está asociado el control enlazado a datos, si existe. (Se hereda de HierarchicalDataBoundControl).
Método protegidoGetDesignModeStateInfraestructura. Obtiene datos en tiempo de diseño para un control. (Se hereda de Control).
Método públicoGetHashCode Sirve como una función hash para un tipo en particular. (Se hereda de Object).
Método públicoGetRouteUrl(Object)Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta. (Se hereda de Control).
Método públicoGetRouteUrl(RouteValueDictionary)Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta. (Se hereda de Control).
Método públicoGetRouteUrl(String, Object)Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta. (Se hereda de Control).
Método públicoGetRouteUrl(String, RouteValueDictionary)Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta. (Se hereda de Control).
Método públicoGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método públicoGetUniqueIDRelativeToDevuelve la parte correspondiente al prefijo de la propiedad UniqueID del control especificado. (Se hereda de Control).
Método públicoHasControlsDetermina si el control de servidor contiene controles secundarios. (Se hereda de Control).
Método protegidoHasEventsDevuelve un valor que indica si se registran eventos para el control o los controles secundarios. (Se hereda de Control).
Método protegidoIsLiteralContentInfraestructura. Determina si el control de servidor alberga únicamente contenido literal. (Se hereda de Control).
Método protegidoLoadControlStateRestaura información de estado de control de una solicitud de página anterior guardada por el método SaveControlState. (Se hereda de Control).
Método protegidoLoadPostDataProcesa los datos de postback del control TreeView.
Método protegidoLoadViewStateInfraestructura. Carga el estado de vista previamente guardado del control TreeView. (Invalida a WebControl.LoadViewState(Object)).
Método protegidoMapPathSecureRecupera la ruta de acceso física a la que se asigna una ruta de acceso virtual, absoluta o relativa. (Se hereda de Control).
Método protegidoMarkAsDataBoundEstablece el estado del control en estado de vista como enlazado correctamente a los datos. (Se hereda de HierarchicalDataBoundControl).
Método protegidoMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método públicoMergeStyleCopia en el control Web todos los elementos no vacíos del estilo especificado, pero no sobrescribe los elementos de estilo existentes en el mismo. Este método lo usan principalmente los desarrolladores de controles. (Se hereda de WebControl).
Método protegidoOnBubbleEventDetermina si el evento del control de servidor debe pasarse a la jerarquía de controles de servidor de la interfaz de usuario de la página. (Se hereda de Control).
Método protegidoOnDataBindingGenera el evento DataBinding. (Se hereda de Control).
Método protegidoOnDataBoundGenera el evento DataBound. (Se hereda de BaseDataBoundControl).
Método protegidoOnDataPropertyChangedSe le llama cuando cambia una de las propiedades de identificación del origen de datos base, para volver a enlazar el control enlazado a datos con sus datos. (Se hereda de HierarchicalDataBoundControl).
Método protegidoOnDataSourceChangedSe le llama cuando la instancia de IHierarchicalDataSource con la que funciona el control enlazado a datos provoca el evento DataSourceChanged. (Se hereda de HierarchicalDataBoundControl).
Método protegidoOnInitGenera el evento Init. (Invalida a BaseDataBoundControl.OnInit(EventArgs)).
Método protegidoOnLoadControla el evento Load. (Se hereda de HierarchicalDataBoundControl).
Método protegidoOnPagePreLoadEstablece el estado inicializado del control enlazado a datos antes de cargar el control. (Se hereda de HierarchicalDataBoundControl).
Método protegidoOnPreRenderGenera el evento Control.PreRender. (Invalida a BaseDataBoundControl.OnPreRender(EventArgs)).
Método protegidoOnSelectedNodeChangedProvoca el evento SelectedNodeChanged del control TreeView.
Método protegidoOnTreeNodeCheckChangedProvoca el evento TreeNodeCheckChanged del control TreeView.
Método protegidoOnTreeNodeCollapsedProvoca el evento TreeNodeCollapsed del control TreeView.
Método protegidoOnTreeNodeDataBoundProvoca el evento TreeNodeDataBound del control TreeView.
Método protegidoOnTreeNodeExpandedProvoca el evento TreeNodeExpanded del control TreeView.
Método protegidoOnTreeNodePopulateProvoca el evento TreeNodePopulate del control TreeView.
Método protegidoOnUnloadGenera el evento Unload. (Se hereda de Control).
Método protegidoOpenFileObtiene un objeto Stream utilizado para leer un archivo. (Se hereda de Control).
Método protegidoPerformDataBindingInfraestructura. Crea todos los nodos basándose en el origen de datos. (Invalida a HierarchicalDataBoundControl.PerformDataBinding()).
Método protegidoPerformSelectRecupera los datos del origen de datos asociado. (Se hereda de HierarchicalDataBoundControl).
Método protegidoRaiseBubbleEventAsigna los orígenes del evento y su información al control principal del control. (Se hereda de Control).
Método protegidoRaiseCallbackEventInfraestructura. Provoca el evento de devolución de llamada con los argumentos especificados.
Método protegidoRaisePostBackEventPermite que el control TreeView procese un evento provocado al devolver un formulario al servidor. El método RaisePostBackEvent es un método auxiliar para el método ICallbackEventHandler.RaiseCallbackEvent.
Método protegidoRaisePostDataChangedEventInfraestructura. Indica al control TreeView que debe notificar a la aplicación ASP.NET que el estado del control ha cambiado.
Método protegidoRemovedControlSe le llama una vez que se ha quitado un control secundario de la colección Controls del Control objeto. (Se hereda de Control).
Método protegidoRenderPresenta el control en el sistema de escritura HTML especificado. (Se hereda de WebControl).
Método públicoRenderBeginTagRepresenta la etiqueta HTML de apertura del control en el sistema de escritura especificado. (Invalida a WebControl.RenderBeginTag(HtmlTextWriter)).
Método protegidoRenderChildrenEnvía el contenido del control secundario del control de servidor a un objeto HtmlTextWriter suministrado, que escribe el contenido que se va a representar en el cliente. (Se hereda de Control).
Método protegidoRenderContentsRepresenta los nodos del control TreeView. (Invalida a WebControl.RenderContents(HtmlTextWriter)).
Método públicoRenderControl(HtmlTextWriter)Envía el contenido del control de servidor a un objeto HtmlTextWriter que se proporciona y almacena la información de traza sobre el control si dicha traza está habilitada. (Se hereda de Control).
Método protegidoRenderControl(HtmlTextWriter, ControlAdapter)Coloca el contenido de un control de servidor en un objeto HtmlTextWriter proporcionado, utilizando un objeto ControlAdapter proporcionado. (Se hereda de Control).
Método públicoRenderEndTagRepresenta la etiqueta HTML de cierre del control en el sistema de escritura especificado. (Invalida a WebControl.RenderEndTag(HtmlTextWriter)).
Método protegidoResolveAdapterObtiene el adaptador de controles que se encarga de representar el control especificado. (Se hereda de Control).
Método públicoResolveClientUrlObtiene una dirección URL que el explorador puede utilizar. (Se hereda de Control).
Método públicoResolveUrlConvierte una dirección URL en una que el cliente solicitante pueda utilizar. (Se hereda de Control).
Método protegidoSaveControlStateGuarda los cambios de estado de un control de servidor que se hayan producido desde el momento en que se devolvieron al servidor los datos de la página. (Se hereda de Control).
Método protegidoSaveViewStateInfraestructura. Guarda el estado del control TreeView. (Invalida a WebControl.SaveViewState()).
Método protegidoSetDesignModeStateEstablece datos en tiempo de diseño para un control. (Se hereda de Control).
Método protegidoSetNodeDataBoundPermite a una clase derivada establecer si el control TreeNode especificado está enlazado a datos.
Método protegidoSetNodeDataItemPermite que una clase derivada establezca el elemento de datos para el control TreeNode especificado.
Método protegidoSetNodeDataPathPermite que una clase derivada establezca la ruta de datos para el control TreeNode especificado.
Método públicoSetRenderMethodDelegateInfraestructura. Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en el control principal. (Se hereda de Control).
Método públicoSetTraceData(Object, Object)Establece datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, para lo que usa la clave y el valor de los datos de seguimiento. (Se hereda de Control).
Método públicoSetTraceData(Object, Object, Object)Establece datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, para lo que usa el objeto del que se ha realizado seguimiento, así como la clave y el valor de los datos de seguimiento. (Se hereda de Control).
Método públicoToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Método protegidoTrackViewStateInfraestructura. Efectúa el seguimiento de los cambios en el estado de vista del control TreeView para poder almacenarlos en el objeto System.Web.UI.StateBag del control. Se obtiene acceso al objeto System.Web.UI.StateBag a través de la propiedad Control.ViewState. (Invalida a WebControl.TrackViewState()).
Método protegidoValidateDataSourceComprueba que el objeto al que se enlaza un control enlazado a datos es compatible. (Se hereda de HierarchicalDataBoundControl).
Arriba

  NombreDescripción
Evento públicoDataBindingSe produce cuando el control de servidor se enlaza a un origen de datos. (Se hereda de Control).
Evento públicoDataBoundSe produce después de que el control de servidor se enlaza a un origen de datos. (Se hereda de BaseDataBoundControl).
Evento públicoDisposedSe produce cuando un control de servidor se libera de la memoria, lo que constituye la última fase del período de duración de un control de servidor cuando se solicita una página ASP.NET. (Se hereda de Control).
Evento públicoInitTiene lugar al inicializar el control de servidor, que es el primer paso en su ciclo de vida. (Se hereda de Control).
Evento públicoLoadSe produce cuando el control de servidor se carga en el objeto Page. (Se hereda de Control).
Evento públicoPreRenderSe produce una vez que se carga el objeto Control, pero antes de su representación. (Se hereda de Control).
Evento públicoSelectedNodeChangedSe desencadena cuando se selecciona un nodo en el control TreeView.
Evento públicoTreeNodeCheckChangedSe produce cuando una casilla del control TreeView cambia de estado entre cada envío al servidor.
Evento públicoTreeNodeCollapsedSe desencadena cuando se contrae un nodo en el control TreeView.
Evento públicoTreeNodeDataBoundSe desencadena cuando un elemento de datos se enlaza a un nodo en el control TreeView.
Evento públicoTreeNodeExpandedSe desencadena cuando se expande un nodo en el control TreeView.
Evento públicoTreeNodePopulateAparece cuando un nodo con su propiedad PopulateOnDemand establecida en true se expande en el control TreeView.
Evento públicoUnloadSe produce cuando el control de servidor se descarga de la memoria. (Se hereda de Control).
Arriba

  NombreDescripción
Método de extensión públicoEnablePersistedSelectionPermite conservar la selección en los controles de datos que admiten la selección y paginación. (Definido por DynamicDataExtensions).
Método de extensión públicoFindDataSourceControlDevuelve el origen de datos que está asociado al control de datos del control especificado. (Definido por DynamicDataExtensions).
Método de extensión públicoFindFieldTemplateDevuelve la plantilla de campo para la columna especificada en el contenedor de nomenclatura del control especificado. (Definido por DynamicDataExtensions).
Método de extensión públicoFindMetaTableDevuelve el objeto de metatabla para el control de datos contenedor. (Definido por DynamicDataExtensions).
Arriba

  NombreDescripción
Implementación explícita de interfacesMétodo privadoIAttributeAccessor.GetAttributeInfraestructura. Obtiene un atributo del control Web con el nombre especificado. (Se hereda de WebControl).
Implementación explícita de interfacesMétodo privadoIAttributeAccessor.SetAttributeEstablece un atributo del control Web con el nombre y el valor especificados. (Se hereda de WebControl).
Implementación explícita de interfacesMétodo privadoICallbackEventHandler.GetCallbackResultInfraestructura. Devuelve el resultado de un evento de devolución de llamada que tiene como destino un control.
Implementación explícita de interfacesMétodo privadoICallbackEventHandler.RaiseCallbackEventInfraestructura. Provoca el evento de devolución de llamada con los argumentos especificados.
Implementación explícita de interfacesPropiedad privadaIControlBuilderAccessor.ControlBuilderPara obtener una descripción de este miembro, vea IControlBuilderAccessor.ControlBuilder. (Se hereda de Control).
Implementación explícita de interfacesMétodo privadoIControlDesignerAccessor.GetDesignModeStatePara obtener una descripción de este miembro, vea IControlDesignerAccessor.GetDesignModeState. (Se hereda de Control).
Implementación explícita de interfacesMétodo privadoIControlDesignerAccessor.SetDesignModeStatePara obtener una descripción de este miembro, vea IControlDesignerAccessor.SetDesignModeState. (Se hereda de Control).
Implementación explícita de interfacesMétodo privadoIControlDesignerAccessor.SetOwnerControlInfraestructura. Para obtener una descripción de este miembro, vea IControlDesignerAccessor.SetOwnerControl. (Se hereda de Control).
Implementación explícita de interfacesPropiedad privadaIControlDesignerAccessor.UserDataPara obtener una descripción de este miembro, vea IControlDesignerAccessor.UserData. (Se hereda de Control).
Implementación explícita de interfacesPropiedad privadaIDataBindingsAccessor.DataBindingsPara obtener una descripción de este miembro, vea IDataBindingsAccessor.DataBindings. (Se hereda de Control).
Implementación explícita de interfacesPropiedad privadaIDataBindingsAccessor.HasDataBindingsPara obtener una descripción de este miembro, vea IDataBindingsAccessor.HasDataBindings. (Se hereda de Control).
Implementación explícita de interfacesPropiedad privadaIExpressionsAccessor.ExpressionsPara obtener una descripción de este miembro, vea IExpressionsAccessor.Expressions. (Se hereda de Control).
Implementación explícita de interfacesPropiedad privadaIExpressionsAccessor.HasExpressionsPara obtener una descripción de este miembro, vea IExpressionsAccessor.HasExpressions. (Se hereda de Control).
Implementación explícita de interfacesMétodo privadoIParserAccessor.AddParsedSubObjectPara obtener una descripción de este miembro, vea IParserAccessor.AddParsedSubObject. (Se hereda de Control).
Implementación explícita de interfacesMétodo privadoIPostBackDataHandler.LoadPostDataInfraestructura. Procesa los datos de postback del control TreeView.
Implementación explícita de interfacesMétodo privadoIPostBackDataHandler.RaisePostDataChangedEventInfraestructura. Indica al control TreeView que debe notificar a la aplicación ASP.NET que el estado del control ha cambiado.
Implementación explícita de interfacesMétodo privadoIPostBackEventHandler.RaisePostBackEventInfraestructura. Permite que el control TreeView procese un evento provocado al devolver un formulario al servidor.
Arriba

En este tema:

Introducción

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

  • Enlace de datos que permite enlazar los nodos del control a datos XML, tabulares o relacionales.

  • Navegación del sitio mediante la integración con el control SiteMapDataSource.

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

  • Acceso mediante programación al modelo de objetos TreeView para crear árboles, rellenar nodos, establecer propiedades, etc., de forma dinámica.

  • Población de nodos del cliente (en exploradores compatibles).

  • La capacidad para mostrar una casilla al lado de cada nodo.

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

    NotaNota

    El control TreeView está diseñado para usarse dentro de un control UpdatePanel solo cuando EnableClientScript está establecido en true. Los controles UpdatePanel se usan para actualizar regiones seleccionadas de una página en lugar de actualizar la página entera con un postback. Para obtener más información, vea UpdatePanel Control Overview y Partial-Page Rendering Overview.

Nodos

El control TreeView se compone de nodos. Cada entrada del árbol se denomina nodo y se representa mediante un objeto TreeNode. Los tipos de nodo se definen como sigue:

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

  • El nodo contenido en otro nodo se denomina nodo secundario.

  • Un nodo que no tiene nodos derivados se denomina nodo de hoja.

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

Un nodo puede ser a la vez un elemento primario y secundario, pero los nodos raíz, primario y de hoja son mutuamente excluyentes. Varias propiedades visuales y conductuales de los nodos vienen determinadas por si un nodo es raíz, secundario o de hoja.

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

Cada nodo tiene una propiedad Text y una propiedad Value. El valor de la propiedad Text se muestra en el control TreeView, mientras que la propiedad Value se utiliza para almacenar cualquier información adicional sobre el nodo, tal como los datos que se pasan al evento de postback asociado al nodo.

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

NotaNota

Algunos exploradores de Internet tienen una limitación que puede afectar al rendimiento del control TreeView. Por ejemplo, Microsoft Internet Explorer 6.0 no puede exponer más de 2067 caracteres de dirección URL. Si el número de caracteres de una dirección URL de un nodo supera ese número, no se podrá expandir ese nodo y no se producirá ninguna excepción.

Datos estáticos

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

Enlace a datos

El control TreeView también se puede enlazar a datos. Para enlazar el control TreeView al tipo de origen de datos adecuado, puede utilizar uno cualquiera de los dos métodos siguientes:

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

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

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

Nota de seguridadNota sobre la seguridad

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

Población de nodo dinámica

En ocasiones, no es práctico definir estáticamente la estructura del árbol porque el origen de datos devuelve demasiados datos o porque los datos a mostrar dependen de la información obtenida en tiempo de ejecución. Por ello, el control TreeView admite que los nodos se rellenen de forma dinámica. Cuando se establece la propiedad PopulateOnDemand de un nodo en true, el nodo se rellena en tiempo de ejecución cuando se expande. Para rellenar dinámicamente un nodo, debe definir un método de control de eventos que contenga la lógica para rellenar un nodo para el evento TreeNodePopulate.

Los exploradores que admiten scripts de devolución de llamada también pueden sacar partido del llenado de nodos en el cliente. (Se incluyen Internet Explorer 5.5 y versiones posteriores y algunos otros exploradores.) El relleno de nodos del lado cliente habilita el control TreeView para rellenar un nodo mediante script de cliente cuando los usuarios expanden el nodo, sin necesidad de una acción de ida y vuelta al servidor. Para obtener más información sobre el rellenado en el cliente, vea PopulateNodesFromClient.

Personalizar la interfaz de usuario

Existen muchas maneras de personalizar el aspecto del control TreeView. En primer lugar, puede especificar un estilo diferente (por ejemplo, tamaño y color de fuente) 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. Si se utilizan ambos, se podrían producir resultados inesperados. Para obtener más información sobre cómo utilizar hojas de estilos con controles, vea ASP.NET Web Server Controls and CSS Styles.

La tabla siguiente enumera los estilos de nodo disponibles.

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 del nodo seleccionado.

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

NotaNota

Si se define un estilo para cierto nivel de profundidad utilizando la colección LevelStyles, ese estilo reemplaza las configuraciones de estilo de nodo raíz, primario u hoja para los nodos a esa profundidad.

Otra manera de modificar el aspecto del control es la personalización de las imágenes que se muestran en el control TreeView. Puede especificar su propio conjunto personalizada de imágenes para las diferentes partes del control estableciendo las propiedades que aparecen 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. La propiedad ShowLines debe establecerse también en true para que surta efecto.

NoExpandImageUrl

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

NotaNota

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 control TreeView también permite mostrar una casilla junto a un nodo. Cuando la propiedad ShowCheckBoxes se establece en un valor distinto de TreeNodeTypes.None, se muestran casillas junto a los tipos de nodo especificados.

NotaNota

La propiedad ShowCheckBoxes se puede establecer en una combinación bit a bit de valores de miembros de la enumeración TreeNodeTypes.

Cada vez que se manda la página por correo al servidor, la colección CheckedNodes se rellena automáticamente con los nodos seleccionados. Cuando se muestren las casillas, puede utilizar el evento TreeNodeCheckChanged para ejecutar una rutina personalizada siempre que cambie el estado de una casilla entre envíos al servidor.

Eventos

El control TreeView proporciona varios eventos que puede utilizar para programar. De esta manera, se puede ejecutar una rutina personalizada siempre que se produzca un evento. En la siguiente tabla se enumeran los eventos admitidos por el control TreeView.

Evento

Descripción

TreeNodeCheckChanged

Se produce cuando las casillas del control TreeView cambian entre cada envío al servidor.

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

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

TreeNodeDataBound

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

Desplazamiento

El control TreeView no tiene desplazamiento integrado. Para agregar el desplazamiento, coloque el control TreeView en un control Panel y agregue las barras de desplazamiento al control Panel. Para obtener más información, vea Panel Web Server Control Overview.

Accesibilidad

El marcado que se presenta de forma predeterminada para este control no podría cumplir a las normas de accesibilidad. Para obtener detalles sobre accesibilidad respecto a este control, vea ASP.NET Controls and Accessibility.

Sintaxis de la declaración

<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>
TopicLocation
Tutorial: Mostrar datos jerárquicos en un control TreeViewGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Personalizar un sitio Web mediante temas en Visual StudioGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Agregar o eliminar elementos del nodo deTreeView (Visual Studio)Generar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Agregar la función de exploración de sitios WebGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Filtrar nodos de mapas de los sitios basándose en las funciones de seguridadGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Agregar la función de exploración de sitios WebGenerar aplicaciones con Visual Web Developer
Tutorial: Personalizar un sitio Web mediante temas en Visual StudioGenerar aplicaciones con Visual Web Developer
Cómo: Enumerar los nodos del mapa del sitio mediante programaciónGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Agregar o eliminar elementos de nodos de TreeViewGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Configurar varios mapas de sitio y proveedores de mapas de sitioGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Filtrar los nodos recuperados por controles SiteMapDataSource de servidor WebGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Mostrar datos jerárquicos en un control TreeViewGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Filtrar nodos de mapas de los sitios basándose en las funciones de seguridadGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Personalizar la apariencia de los controles SiteMapPath de servidor WebGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Mostrar los datos de mapas de sitio de controles no jerárquicos de servidor webGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Agregar la función de exploración a sitios sencillosGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Implementar proveedores de mapas de sitio de ASP.NETGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Filtrar los nodos recuperados por controles SiteMapDataSource de servidor WebGenerar aplicaciones Web ASP .NET
Cómo: Configurar varios mapas de sitio y proveedores de mapas de sitioGenerar aplicaciones Web ASP .NET
Cómo: Implementar proveedores de mapas de sitio de ASP.NETGenerar aplicaciones Web ASP .NET
Cómo: Enumerar los nodos del mapa del sitio mediante programaciónGenerar aplicaciones Web ASP .NET
Cómo: Personalizar la apariencia de los controles SiteMapPath de servidor WebGenerar aplicaciones Web ASP .NET
Cómo: Mostrar los datos de mapas de sitio de controles no jerárquicos de servidor WebGenerar aplicaciones Web ASP .NET
Cómo: Agregar la función de exploración a sitios sencillosGenerar aplicaciones Web ASP .NET
Cómo: Enumerar los nodos del mapa del sitio mediante programaciónGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Configurar varios mapas de sitio y proveedores de mapas de sitioGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Filtrar los nodos recuperados por controles SiteMapDataSource de servidor WebGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Personalizar la apariencia de los controles SiteMapPath de servidor WebGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Mostrar los datos de mapas de sitio de controles no jerárquicos de servidor webGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Agregar la función de exploración a sitios sencillosGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Implementar proveedores de mapas de sitio de ASP.NETGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Agregar o eliminar elementos de nodos de TreeViewGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Mostrar datos jerárquicos en un control TreeViewGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Filtrar nodos de mapas de los sitios basándose en las funciones de seguridadGenerar aplicaciones Web ASP .NET en Visual Studio

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

  • El primer ejemplo de código muestra cómo configurar los marcos para obtener 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 control TreeView.

  • El tercer ejemplo de código muestra cómo enlazar el control TreeView 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 control TreeView para la navegación del sitio enlazándolo a un control SiteMapDataSource.

  • El sexto ejemplo de código proporciona datos del 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 control TreeView desde el cliente.

El siguiente ejemplo de código muestra cómo configurar los marcos para obtener el siguiente ejemplo de código.



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



El siguiente ejemplo de código muestra cómo utilizar la sintaxis declarativa para mostrar datos estáticos en el control TreeView. Este ejemplo se utiliza dentro del conjunto de marcos 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>



El ejemplo de código siguiente muestra cómo enlazar el control TreeView a un origen de datos XML. Para que este ejemplo funcione correctamente, debe copiar los datos XML de ejemplo que se proporcionan más abajo 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>



En el siguiente ejemplo de código se proporciona 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>
</Book>

El siguiente ejemplo de código muestra cómo utilizar el control TreeView para la navegación del sitio enlazándolo a un control SiteMapDataSource. Para que este ejemplo funcione correctamente, debe copiar los datos del mapa del sitio de ejemplo, proporcionados después de este ejemplo de código, a 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 del 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>

El siguiente ejemplo de código muestra cómo rellenar los nodos en el control TreeView desde el cliente. Cuando se habilita el relleno de nodo del lado cliente, los nodos se rellenan dinámicamente en el cliente, sin necesidad de devolver datos al 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

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft