SiteMapProvider.GetCurrentNodeAndHintNeighborhoodNodes(Int32, Int32) Méthode

  • Référence

Définition

Espace de noms:
System.Web
Assembly:
System.Web.dll

Fournit une méthode de recherche optimisée aux fournisseurs de plan de site lors de la récupération du nœud pour la page actuellement demandée et lors de l'extraction de nœuds de plan de site situés à proximité du nœud actuel.

public:
 virtual System::Web::SiteMapNode ^ GetCurrentNodeAndHintNeighborhoodNodes(int upLevel, int downLevel);
public virtual System.Web.SiteMapNode GetCurrentNodeAndHintNeighborhoodNodes (int upLevel, int downLevel);
abstract member GetCurrentNodeAndHintNeighborhoodNodes : int * int -> System.Web.SiteMapNode
override this.GetCurrentNodeAndHintNeighborhoodNodes : int * int -> System.Web.SiteMapNode
Public Overridable Function GetCurrentNodeAndHintNeighborhoodNodes (upLevel As Integer, downLevel As Integer) As SiteMapNode

Paramètres

upLevel
Int32

Nombre de générations de SiteMapNode ancêtres à extraire. 0 indique qu'aucun nœud ancêtre n'est récupéré et -1 indique que le fournisseur peut récupérer et mettre en cache tous les ancêtres.

downLevel
Int32

Nombre de générations de SiteMapNode enfants à extraire. 0 indiquent qu'aucun nœud descendant n'est récupéré et un -1 indique que le fournisseur peut récupérer et mettre en cache tous les nœuds descendants.

Retours

SiteMapNode

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

Exceptions

ArgumentOutOfRangeException

upLevel ou downLevel est inférieur à -1.

Remarques

L’implémentation par défaut de la GetCurrentNodeAndHintNeighborhoodNodes méthode retourne la CurrentNode propriété ; toutefois, les fournisseurs de plan de site peuvent remplacer la GetCurrentNodeAndHintNeighborhoodNodes méthode et fournir une implémentation optimisée qui utilise des mécanismes de mise en cache personnalisés pour retourner l’objet actuel SiteMapNode , ainsi que SiteMapNode des objets qui se trouvent à proximité du actuel SiteMapNode.

Le upLevel paramètre est utilisé pour spécifier le nombre de niveaux de nœuds parents et ancêtres à récupérer et mettre en cache, ainsi que leurs enfants immédiats. Le downLevel paramètre est utilisé pour spécifier le nombre de niveaux de nœuds descendants du actuel SiteMapNode à 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 le

GetCurrentNodeAndHintNeighborhoodNodes à l’aide des ParentNode propriétés et ChildNodes . S’il y a moins de niveaux de nœuds ancêtres ou enfants que ceux spécifiés par upLevel ou downLevel, seuls ceux qui sont disponibles sont récupérés.

La XmlSiteMapProvider classe, qui est le fournisseur de plan de site par défaut pour ASP.NET, met en cache l’intégralité du mappage de site en mémoire, ce qui entraîne peu ou pas de surcharge lors de l’interrogation d’objets XmlSiteMapProvider spécifiques SiteMapNode .

S’applique à

Voir aussi