Lire en anglais

Partager via


SiteMapProvider.GetParentNodeRelativeToNodeAndHintDownFromParent 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 l'objet SiteMapNode spécifié et lors de l'extraction de ses nœuds enfants.

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

Paramètres

node
SiteMapNode

SiteMapNode qui agit en tant que point de référence pour walkupLevels et relativeDepthFromWalkup.

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

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

Exceptions

La valeur spécifiée pour walkupLevels ou relativeDepthFromWalkup est inférieure à 0.

node a la valeur null.

Remarques

L’implémentation par défaut de la SiteMapProvider classe fournit une implémentation non optimisée de la GetParentNodeRelativeToNodeAndHintDownFromParent méthode, appelant les HintAncestorNodes méthodes HintNeighborhoodNodes ; toutefois, les fournisseurs de carte de site peuvent remplacer la GetParentNodeRelativeToNodeAndHintDownFromParent méthode et fournir une implémentation optimisée qui utilise des mécanismes de mise en cache personnalisés pour renvoyer le nœud ancêtre et effectuer une recherche optimisée des autres SiteMapNode objets. La GetParentNodeRelativeToNodeAndHintDownFromParent méthode est très similaire à la GetParentNodeRelativeToCurrentNodeAndHintDownFromParent méthode.

Le walkupLevels paramètre est utilisé pour spécifier le nombre de niveaux de nœuds parent et ancêtres à parcourir lors de la récupération du nœud cible. Si moins de niveaux existent 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 à ceux SiteMapNode retournés par la méthode, à l’aide GetParentNodeRelativeToNodeAndHintDownFromParent des propriétés et ChildNodes des ParentNode propriétés. S’il existe moins de niveaux de nœud ancêtres que spécifiés par le upLevel paramètre, null est retourné. Il est à l’implémenteur de fournisseur de décider comment gérer la situation où le nombre de niveaux de nœud descendant disponibles est inférieur à la valeur spécifiée par le downLevel paramètre.

S’applique à

Voir aussi