Compartir a través de


SiteMapProvider.GetParentNodeRelativeToNodeAndHintDownFromParent Método

Definición

Proporciona un método de búsqueda optimizado para los proveedores del mapa del sitio al recuperar un nodo antecesor para el objeto SiteMapNode especificado y extraer sus nodos secundarios.

public:
 virtual System::Web::SiteMapNode ^ GetParentNodeRelativeToNodeAndHintDownFromParent(System::Web::SiteMapNode ^ node, int walkupLevels, int relativeDepthFromWalkup);
public virtual System.Web.SiteMapNode GetParentNodeRelativeToNodeAndHintDownFromParent (System.Web.SiteMapNode node, int walkupLevels, int relativeDepthFromWalkup);
abstract member GetParentNodeRelativeToNodeAndHintDownFromParent : System.Web.SiteMapNode * int * int -> System.Web.SiteMapNode
override this.GetParentNodeRelativeToNodeAndHintDownFromParent : System.Web.SiteMapNode * int * int -> System.Web.SiteMapNode
Public Overridable Function GetParentNodeRelativeToNodeAndHintDownFromParent (node As SiteMapNode, walkupLevels As Integer, relativeDepthFromWalkup As Integer) As SiteMapNode

Parámetros

node
SiteMapNode

SiteMapNode que actúa como punto de referencia para walkupLevels y relativeDepthFromWalkup.

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 node antecesor; de lo contrario, es null si no se encuentra el SiteMapNode actual o antecesor, o no se puede devolver para el usuario actual.

Excepciones

El valor especificado para walkupLevels o relativeDepthFromWalkup es menor que 0.

node es null.

Comentarios

La implementación predeterminada de la SiteMapProvider clase proporciona una implementación no optimizada del GetParentNodeRelativeToNodeAndHintDownFromParent método , llamando a los HintAncestorNodes métodos y HintNeighborhoodNodes ; sin embargo, los proveedores de mapas de sitio pueden invalidar el GetParentNodeRelativeToNodeAndHintDownFromParent 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 GetParentNodeRelativeToNodeAndHintDownFromParent método es muy similar al GetParentNodeRelativeToCurrentNodeAndHintDownFromParent método .

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 GetParentNodeRelativeToNodeAndHintDownFromParent método , mediante las ParentNode propiedades y ChildNodes . Si hay menos niveles de nodo antecesor de los especificados por el upLevel parámetro , null se devuelve . Es necesario que el implementador del proveedor decida cómo controlar la situación en la que el número de niveles de nodo descendiente disponibles es menor que el valor especificado por el downLevel parámetro .

Se aplica a

Consulte también