SiteMapProvider.GetParentNodeRelativeToCurrentNodeAndHintDownFromParent 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 al recuperar un nodo antecesor correspondiente a la página solicitada actualmente y extraer los nodos descendientes del antecesor.

public:
 virtual System::Web::SiteMapNode ^ GetParentNodeRelativeToCurrentNodeAndHintDownFromParent(int walkupLevels, int relativeDepthFromWalkup);

public virtual System.Web.SiteMapNode GetParentNodeRelativeToCurrentNodeAndHintDownFromParent (int walkupLevels, int relativeDepthFromWalkup);

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

Public Overridable Function GetParentNodeRelativeToCurrentNodeAndHintDownFromParent (walkupLevels As Integer, relativeDepthFromWalkup As Integer) As SiteMapNode

Parámetros

walkupLevels

Int32

Número de niveles de nodos antecesores que se recorrerán para recuperar el nodo antecesor solicitado.

relativeDepthFromWalkup

Int32

Número de niveles de nodos descendientes que se recuperarán para el nodo antecesor de destino.

Devoluciones

SiteMapNode

Es un SiteMapNode que representa un SiteMapNode antecesor de la página solicitada actualmente; de lo contrario, es null si no se encuentra el SiteMapNode actual o antecesor, o no se puede devolver para el usuario actual.

Excepciones

ArgumentOutOfRangeException

walkupLevels o relativeDepthFromWalkup es menor que 0.

Comentarios

La implementación predeterminada de la SiteMapProvider clase proporciona una implementación no optimizada del GetParentNodeRelativeToCurrentNodeAndHintDownFromParent método , llamando a los GetCurrentNodeAndHintAncestorNodes métodos y HintNeighborhoodNodes ; sin embargo, los proveedores de mapas de sitio pueden invalidar el GetParentNodeRelativeToCurrentNodeAndHintDownFromParent método y proporcionar una implementación optimizada que usa mecanismos de almacenamiento en caché personalizados para devolver el nodo antecesor y realizar una búsqueda optimizada de los demás SiteMapNode objetos.

El walkupLevels parámetro se usa para especificar cuántos niveles de nodos primarios y antecesores recorrer al recuperar el nodo de destino. Si existen menos niveles de los solicitados, null se devuelve. El downLevel parámetro se usa para especificar cuántos niveles de nodos descendientes del nodo antecesor de destino se van a recuperar. Si se prefiere, los nodos antecesores y descendientes se pueden vincular al SiteMapNode que devuelve el GetParentNodeRelativeToCurrentNodeAndHintDownFromParent método , mediante las ParentNode propiedades y ChildNodes .

Consulte también

• GetParentNodeRelativeToNodeAndHintDownFromParent(SiteMapNode, Int32, Int32)