SiteMapProvider.GetCurrentNodeAndHintAncestorNodes(Int32) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona un método de búsqueda optimizado para los proveedores del mapa del sitio en las operaciones de recuperación de un nodo para hallar la página solicitada actualmente y de extracción de los nodos primarios y antecesores del mapa del sitio correspondientes a la página actual.
public:
virtual System::Web::SiteMapNode ^ GetCurrentNodeAndHintAncestorNodes(int upLevel);public virtual System.Web.SiteMapNode GetCurrentNodeAndHintAncestorNodes (int upLevel);abstract member GetCurrentNodeAndHintAncestorNodes : int -> System.Web.SiteMapNode
override this.GetCurrentNodeAndHintAncestorNodes : int -> System.Web.SiteMapNodePublic Overridable Function GetCurrentNodeAndHintAncestorNodes (upLevel As Integer) As SiteMapNodeParámetros
- upLevel
- Int32
Número de generaciones de nodos antecesores del mapa del sitio que se van a obtener. El valor -1 indica que el proveedor puede recuperar y almacenar en memoria caché todos los antecesores.
Devoluciones
Es un SiteMapNode que representa la página solicitada actualmente; de lo contrario, es null si SiteMapNode no se encuentra o no se puede devolver para el usuario actual.
Excepciones
upLevel es menor que 1.
Comentarios
La implementación predeterminada del GetCurrentNodeAndHintAncestorNodes método devuelve la CurrentNode propiedad; sin embargo, los proveedores de mapas de sitio pueden invalidar el GetCurrentNodeAndHintAncestorNodes método y proporcionar una implementación optimizada que usa mecanismos de almacenamiento en caché personalizados para devolver el actual SiteMapNode, así como los nodos primarios y antecesores del elemento primario.
El upLevel parámetro se usa para especificar cuántos niveles de nodos primarios y antecesores se van a recuperar. Si se prefiere, los nodos primarios y antecesores se pueden vincular al SiteMapNode objeto devuelto por el GetCurrentNodeAndHintAncestorNodes método , mediante la ParentNode propiedad .
La XmlSiteMapProvider clase , que es el proveedor de mapa de sitio predeterminado para ASP.NET, almacena en caché todo el mapa de sitio en memoria, lo que produce poca o ninguna sobrecarga al consultar el XmlSiteMapProvider objeto para objetos específicosSiteMapNode.