Partager via


SiteMapProvider.GetParentNodeRelativeToCurrentNodeAndHintDownFromParent Méthode

Définition

Fournit une méthode de recherche optimisée pour les fournisseurs de plan de site lors de la récupération d'un nœud ancêtre pour la page actuellement demandée et lors de l'extraction des nœuds descendants pour l'ancêtre.

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

Paramètres

walkupLevels
Int32

Nombre de niveaux de nœuds ancêtres à parcourir lors de la récupération du nœud ancêtre demandé.

relativeDepthFromWalkup
Int32

Nombre de niveaux de nœuds descendants à récupérer à partir du nœud ancêtre cible.

Retours

SiteMapNode qui représente un ancêtre SiteMapNode de la page actuellement demandée ; sinon, null, si le SiteMapNode courant ou ancêtre est introuvable ou s'il ne peut pas être retourné pour l'utilisateur actuel.

Exceptions

walkupLevels ou relativeDepthFromWalkup est inférieur à 0.

Remarques

L’implémentation par défaut de la SiteMapProvider classe fournit une implémentation non optimisée de la GetParentNodeRelativeToCurrentNodeAndHintDownFromParent méthode, appelant les GetCurrentNodeAndHintAncestorNodes méthodes et HintNeighborhoodNodes . Toutefois, les fournisseurs de plan de site peuvent remplacer la GetParentNodeRelativeToCurrentNodeAndHintDownFromParent méthode et fournir une implémentation optimisée qui utilise des mécanismes de mise en cache personnalisés pour retourner le nœud ancêtre et effectuer une recherche optimisée des autres SiteMapNode objets.

Le walkupLevels paramètre est utilisé pour spécifier le nombre de niveaux de nœuds parents et ancêtres à parcourir lors de la récupération du nœud cible. S’il existe moins de niveaux que ceux demandés, null est retourné. Le downLevel paramètre est utilisé pour spécifier le nombre de niveaux de nœuds descendants du nœud ancêtre cible à récupérer. Si vous préférez, les nœuds ancêtres et descendants peuvent être liés au SiteMapNode qui est retourné par la GetParentNodeRelativeToCurrentNodeAndHintDownFromParent méthode, à l’aide des ParentNode propriétés et ChildNodes .

S’applique à

Voir aussi