SiteMapProvider.GetParentNodeRelativeToCurrentNodeAndHintDownFromParent Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.SiteMapNodePublic Overridable Function GetParentNodeRelativeToCurrentNodeAndHintDownFromParent (walkupLevels As Integer, relativeDepthFromWalkup As Integer) As SiteMapNodeParamè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 .
