¿Le resultó útil esta página?
Sus comentarios sobre este contenido son muy importantes. Háganos saber su opinión.
¿Tiene comentarios adicionales?
Caracteres restantes: 1500
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

SiteMapDataSource (Clase)

Proporciona un control de origen de datos que los controles de servidor Web y otros controles pueden utilizar para enlazarse a los datos del mapa del sitio jerárquico.

System.Object
  System.Web.UI.Control
    System.Web.UI.HierarchicalDataSourceControl
      System.Web.UI.WebControls.SiteMapDataSource

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

[ToolboxBitmapAttribute(typeof(SiteMapDataSource))]
public class SiteMapDataSource : HierarchicalDataSourceControl, 
	IDataSource, IListSource
<asp:SiteMapDataSource />

El tipo SiteMapDataSource expone los siguientes miembros.

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

  NombreDescripción
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úblicaBindingContainerInfraestructura. Obtiene el control que contiene el enlace de datos de este control. (Se hereda de Control).
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 del control de servidor generado por ASP.NET. (Se hereda de HierarchicalDataSourceControl).
Propiedad públicaClientIDModeEsta propiedad no se utiliza para los controles de orígenes de datos. (Se hereda de HierarchicalDataSourceControl).
Propiedad protegidaClientIDSeparatorObtiene un valor de carácter que representa el carácter separado utilizado en la propiedad ClientID. (Se hereda de Control).
Propiedad públicaContainsListCollectionObtiene un valor que indica si el control de origen de datos contiene una colección de objetos de vista de origen de datos.
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 HierarchicalDataSourceControl).
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 protegidaDesignModeObtiene un valor que indica si se está utilizando un control en una superficie de diseño. (Se hereda de Control).
Propiedad públicaEnableThemingObtiene un valor que indica si el control admite temas. (Se hereda de HierarchicalDataSourceControl).
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 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ú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 protegidaIsChildControlStateClearedObtiene un valor que indica si los controles que se encuentran en este control tienen estado de control. (Se hereda de Control).
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 protegidaIsViewStateEnabledObtiene un valor que indica si el estado de vista está habilitado para este control. (Se hereda de Control).
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ú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ú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úblicaProviderObtiene o establece un objeto SiteMapProvider que está asociado al control de origen de datos.
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 públicaShowStartingNodeObtiene o establece un valor que indica si se recupera y se muestra el nodo de inicio.
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úblicaSiteMapProviderObtiene o establece el nombre del proveedor del mapa del sitio al que se enlaza el origen de datos.
Propiedad públicaSkinIDObtiene o establece la máscara que se va a aplicar al control HierarchicalDataSourceControl. (Se hereda de HierarchicalDataSourceControl).
Propiedad públicaStartFromCurrentNodeObtiene o establece un valor que indica si el árbol de nodos del mapa del sitio se recupera utilizando el nodo que representa la página actual.
Propiedad públicaStartingNodeOffsetObtiene o establece un desplazamiento entero positivo o negativo a partir del nodo de inicio que determina la jerarquía raíz expuesta por el control de origen de datos.
Propiedad públicaStartingNodeUrlObtiene o establece un nodo del mapa del sitio que el origen de datos utiliza a continuación como punto de referencia para recuperar nodos de un mapa jerárquico del sitio.
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ú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 muestra gráficamente. (Se hereda de HierarchicalDataSourceControl).
Arriba

  NombreDescripción
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úblicoApplyStyleSheetSkinAplica al control las propiedades de estilo definidas en la hoja de estilos de página. (Se hereda de HierarchicalDataSourceControl).
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 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 un nuevo objeto ControlCollection para guardar los controles secundarios (tanto literales como de servidor) del control de servidor. (Se hereda de HierarchicalDataSourceControl).
Método públicoDataBind()Enlaza un origen de datos al control de servidor invocado y a todos sus controles secundarios. (Se hereda de Control).
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 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 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 HierarchicalDataSourceControl).
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úblicoFocusEstablece el foco de entrada en el control. (Se hereda de HierarchicalDataSourceControl).
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 protegidoGetHierarchicalViewRecupera una vista única sobre los datos del mapa del sitio para el objeto SiteMapProvider según el nodo de inicio y otras propiedades del origen de datos. (Invalida a HierarchicalDataSourceControl.GetHierarchicalView(String)).
Método públicoGetListRecupera una lista de controles de origen de datos que pueden utilizarse como orígenes de listas de datos.
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úblicoGetViewRecupera una vista, con nombre, de los datos del mapa del sitio del proveedor del mapa del sitio según el nodo de inicio y otras propiedades del origen de datos.
Método públicoGetViewNamesRecupera una colección de vistas con nombre para el control de origen de datos.
Método públicoHasControlsDetermina si el control de servidor contiene controles secundarios. (Se hereda de HierarchicalDataSourceControl).
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 protegidoLoadViewStateRestaura la información sobre el estado de vista de una solicitud de página anterior guardada por el método SaveViewState. (Se hereda de Control).
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 protegidoMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
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 protegidoOnDataSourceChangedGenera el evento DataSourceChanged. (Se hereda de HierarchicalDataSourceControl).
Método protegidoOnInitGenera el evento Init. (Se hereda de Control).
Método protegidoOnLoadGenera el evento Load. (Se hereda de Control).
Método protegidoOnPreRenderGenera el evento PreRender. (Se hereda de Control).
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 protegidoRaiseBubbleEventAsigna los orígenes del evento y su información al control principal del control. (Se hereda de Control).
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 protegidoRenderEnvía el contenido 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 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 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 HierarchicalDataSourceControl).
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 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 protegidoSaveViewStateGuarda los cambios realizados en el estado de vista del control de servidor desde la devolución de la página al servidor. (Se hereda de Control).
Método protegidoSetDesignModeStateEstablece datos en tiempo de diseño para un control. (Se hereda de Control).
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 protegidoTrackViewStateOrigina el seguimiento de los cambios del estado de vista del control de servidor de manera que se puedan almacenar en el objeto StateBag del control de servidor. Se obtiene acceso a este objeto a través de la propiedad Control.ViewState. (Se hereda de Control).
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ú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ú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ú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).
Método de extensión públicoGetDefaultValuesObtiene la colección de los valores predeterminados para el origen de datos especificado. (Definido por DynamicDataExtensions).
Método de extensión públicoGetMetaTableObtiene los metadatos para una tabla en el objeto de origen de datos especificado. (Definido por DynamicDataExtensions).
Método de extensión públicoTryGetMetaTableDetermina si están disponibles los metadatos de la tabla. (Definido por DynamicDataExtensions).
Arriba

  NombreDescripción
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 interfacesEvento privadoIDataSource.DataSourceChangedInfraestructura. Se produce cuando un control de origen de datos ha cambiado de alguna manera que afecta a los controles enlazados a datos.
Implementación explícita de interfacesMétodo privadoIDataSource.GetViewInfraestructura. Para obtener una descripción de este miembro, vea GetView.
Implementación explícita de interfacesMétodo privadoIDataSource.GetViewNamesInfraestructura. Para obtener una descripción de este miembro, vea GetViewNames.
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 interfacesEvento privadoIHierarchicalDataSource.DataSourceChangedInfraestructura. Se produce cuando los cambios de HierarchicalDataSourceControl afectan de alguna manera a los controles enlazados a datos. (Se hereda de HierarchicalDataSourceControl).
Implementación explícita de interfacesMétodo privadoIHierarchicalDataSource.GetHierarchicalViewInfraestructura. Obtiene el objeto auxiliar de la vista para la interfaz IHierarchicalDataSource para la ruta de acceso especificada. (Se hereda de HierarchicalDataSourceControl).
Implementación explícita de interfacesPropiedad privadaIListSource.ContainsListCollectionInfraestructura. Obtiene un valor que indica si la colección contiene objetos IList.
Implementación explícita de interfacesMétodo privadoIListSource.GetListInfraestructura. Para obtener una descripción de este miembro, vea GetList.
Implementación explícita de interfacesMétodo privadoIParserAccessor.AddParsedSubObjectPara obtener una descripción de este miembro, vea IParserAccessor.AddParsedSubObject. (Se hereda de Control).
Arriba

En este tema:

Introducción

El control SiteMapDataSource es un origen de datos para los datos del mapa del sitio que almacenan los proveedores del mapa del sitio que están configurados para su sitio. El control SiteMapDataSource habilita a los controles de servidor Web que no son controles de navegación del sitio específicamente, como por ejemplo los controles TreeView, Menu y DropDownList, para enlazar con datos jerárquicos del mapa del sitio. Estos controles de servidor Web se pueden utilizar para mostrar un mapa del sitio como una tabla de contenido o para navegar de forma activa un sitio. Como alternativa, puede utilizar el control SiteMapPath que está diseñado especialmente como control de navegación del sitio y por tanto no necesita una instancia del control SiteMapDataSource.

Especifica el nodo de inicio

El control SiteMapDataSource se enlaza a los datos del mapa del sitio y presenta su vista a partir de un nodo de inicio especificado de la jerarquía del mapa del sitio. De manera predeterminada, ese nodo es el nodo raíz de la jerarquía, pero también puede ser cualquier otro nodo dentro de la jerarquía. El nodo de inicio se identifica mediante los valores de varias propiedades de SiteMapDataSource del siguiente modo:

Nodo de inicio

Valores de propiedad

Nodo raíz de la jerarquía (es el valor predeterminado).

La propiedad StartFromCurrentNode es false.

StartingNodeUrl no se ha establecido.

Nodo que representa la página que se está viendo actualmente.

La propiedad StartFromCurrentNode es true.

StartingNodeUrl no se ha establecido.

Un nodo específico de la jerarquía.

La propiedad StartFromCurrentNode es false.

La propiedad StartingNodeUrl está establecida.

Si la propiedad StartingNodeOffset se establece en un valor distinto de 0, esto afecta al nodo de inicio y con él a la jerarquía de datos del mapa del sitio expuesta por el control SiteMapDataSource. El valor entero negativo o positivo de la propiedad StartingNodeOffset identifica el número de niveles hacia arriba o hacia abajo de la jerarquía del mapa del sitio desde el nodo de inicio identificado por las propiedades StartFromCurrentNode y StartingNodeUrl que hay que desplazar el nodo de inicio del subárbol expuesto por el control de origen de datos.

Si la propiedad StartingNodeOffset se establece en un número negativo -n, el nodo de inicio del subárbol expuesto por el control de origen de datos será el nodo antecesor que se encuentra n niveles jerárquicos por encima del nodo de inicio identificado. Si el valor de n es mayor que el número de niveles antecesores del árbol jerárquico, el nodo de inicio del subárbol será el nodo raíz de la jerarquía del mapa del sitio.

Si la propiedad StartingNodeOffset se establece en un número positivo +n, el nodo de inicio del subárbol expuesto será un nodo secundario situado n niveles por debajo del nodo de inicio identificado. Puesto que la jerarquía podría contener más de una rama de nodos secundarios, el control SiteMapDataSource intenta resolver un nodo secundario directamente en la ruta de acceso entre el nodo de inicio identificado y el nodo que representa la página actualmente solicitada, si es posible. Si el nodo que representa la página actualmente solicitada no está en el subárbol del nodo de inicio identificado, se omitirá el valor de la propiedad StartingNodeOffset. Si el nodo que representa la página actualmente solicitada está a menos de n niveles por debajo del nodo de inicio identificado, se utilizará como nodo de inicio el nodo de la página actualmente solicitada.

Recuperar los datos del mapa del sitio

Los datos del mapa del sitio se recuperan de un objeto SiteMapProvider como XmlSiteMapProvider que es el proveedor de mapa del sitio predeterminado para ASP.NET. Puede especificar cualquier proveedor que se configure para su sitio de modo que proporcione los datos del mapa del sitio a SiteMapDataSource, y puede obtener la lista de proveedores disponibles mediante el acceso a la colección SiteMap.Providers.

Al igual que todos los controles de origen de datos, cada instancia de un control SiteMapDataSource está asociada con un objeto auxiliar único, conocido como vista de origen de datos. El objeto SiteMapDataSourceView es una vista sobre los datos del mapa del sitio, según las propiedades del origen de datos, el cual se puede recuperar llamando al método GetHierarchicalView. El objeto SiteMapDataSourceView mantiene el objeto SiteMapNodeCollection al que se enlazan los controles.

De manera predeterminada, el nodo de inicio es el nodo raíz de la jerarquía, pero se puede establecer en cualquier otro nodo. El punto de inicio puede ser un nodo relativo a la posición actual en el mapa del sitio o a una posición absoluta. Puede especificar el nodo de inicio estableciendo la propiedad StartingNodeUrl.

El control SiteMapDataSourceestá diseñado para datos de navegación, y no admite operaciones comunes con orígenes de datos, tales como ordenar, filtrar, paginar, almacenar en caché, u operaciones con registros de datos, como actualizaciones, inserciones o eliminaciones.

Sintaxis de la declaración

<asp:SiteMapDataSource
    EnableTheming="True|False"
    EnableViewState="True|False"
    ID="string"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    runat="server"
    ShowStartingNode="True|False"
    SiteMapProvider="string"
    SkinID="string"
    StartFromCurrentNode="True|False"
    StartingNodeOffset="integer"
    StartingNodeUrl="uri"
    Visible="True|False"
/>
TopicLocation
Tutorial: Controlar los menús de ASP.NET mediante programaciónGenerar 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
Cómo: Buscar datos de mapas de sitioGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Agregar la función de exploración de sitios WebGenerar aplicaciones con Visual Web Developer
Tutorial: Filtrar nodos de mapas de los sitios basándose en las funciones de seguridadGenerar aplicaciones Web ASP .NET en Visual Studio
Tutorial: Controlar los menús de ASP.NET mediante programaciónGenerar 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: Controlar los menús de ASP.NET mediante programaciónGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Buscar datos de mapas de sitioGenerar aplicaciones Web ASP .NET en Visual Studio
Cómo: Buscar datos de mapas de sitioGenerar aplicaciones Web ASP .NET

El siguiente ejemplo de código muestra cómo enlazar mediante declaración un control TreeView con un mapa del sitio utilizando un control SiteMapDataSource. Los datos del mapa del sitio se obtienen comenzando en el nivel de nodo raíz.


<%@ 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>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">
            <asp:SiteMapDataSource
                id="SiteMapDataSource1"
                runat="server" />

            <asp:TreeView
                id="TreeView1"
                runat="server"
                DataSourceID="SiteMapDataSource1">
            </asp:TreeView>

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