SiteMapProvider.GetParentNodeRelativeToNodeAndHintDownFromParent 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 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);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.SiteMapNodePublic Overridable Function GetParentNodeRelativeToNodeAndHintDownFromParent (node As SiteMapNode, walkupLevels As Integer, relativeDepthFromWalkup As Integer) As SiteMapNodeParamè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 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.