SiteMapProvider.GetCurrentNodeAndHintNeighborhoodNodes(Int32, Int32) Método

Definición

Espacio de nombres:

System.Web

Ensamblado:

System.Web.dll

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 del mapa del sitio próximos al nodo actual.

public:
 virtual System::Web::SiteMapNode ^ GetCurrentNodeAndHintNeighborhoodNodes(int upLevel, int downLevel);

public virtual System.Web.SiteMapNode GetCurrentNodeAndHintNeighborhoodNodes (int upLevel, int downLevel);

abstract member GetCurrentNodeAndHintNeighborhoodNodes : int * int -> System.Web.SiteMapNode
override this.GetCurrentNodeAndHintNeighborhoodNodes : int * int -> System.Web.SiteMapNode

Public Overridable Function GetCurrentNodeAndHintNeighborhoodNodes (upLevel As Integer, downLevel As Integer) As SiteMapNode

Parámetros

upLevel

Int32

Número de generaciones de SiteMapNode antecesores que se van a obtener. 0 indica que no se recuperará ningún nodo antecesor y -1 indica que el proveedor puede recuperar y almacenar en memoria caché todos los antecesores.

downLevel

Int32

Número de generaciones secundarias de SiteMapNode que se van a extraer. 0 indica que no se recuperará ningún nodo descendiente y -1 indica que el proveedor puede recuperar y almacenar en memoria caché todos los descendientes.

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

ArgumentOutOfRangeException

upLevel o downLevel es menor que 1.

Comentarios

La implementación predeterminada del GetCurrentNodeAndHintNeighborhoodNodes método devuelve la CurrentNode propiedad ; sin embargo, los proveedores de mapas de sitio pueden invalidar el GetCurrentNodeAndHintNeighborhoodNodes método y proporcionar una implementación optimizada que usa mecanismos de almacenamiento en caché personalizados para devolver el objeto actual SiteMapNode , así como SiteMapNode los objetos que están en la proximidad del actual SiteMapNode.

El upLevel parámetro se usa para especificar cuántos niveles de nodos primarios y antecesores se van a recuperar y almacenar en caché, junto con sus elementos secundarios inmediatos. El downLevel parámetro se usa para especificar cuántos niveles de nodos descendientes del actual SiteMapNode se van a recuperar. Si se prefiere, los nodos antecesores y descendientes se pueden vincular al SiteMapNode que devuelve .

GetCurrentNodeAndHintNeighborhoodNodes método , mediante las ParentNode propiedades y ChildNodes . Si hay menos niveles de nodo antecesores o secundarios que los especificados por upLevel o downLevel, solo se recuperan los que están disponibles.

La XmlSiteMapProvider clase , que es el proveedor de mapa de sitio predeterminado para ASP.NET, almacena en caché todo el mapa del sitio en la memoria, lo que da lugar a poca o ninguna sobrecarga al consultar los XmlSiteMapProvider objetos específicos SiteMapNode .

Consulte también

• GetCurrentNodeAndHintAncestorNodes(Int32)