Compartir a través de


SiteMapProvider.GetCurrentNodeAndHintAncestorNodes(Int32) Método

Definición

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.SiteMapNode
Public Overridable Function GetCurrentNodeAndHintAncestorNodes (upLevel As Integer) As SiteMapNode

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

SiteMapNode

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.

Se aplica a

Consulte también