SiteMapProvider.GetCurrentNodeAndHintNeighborhoodNodes(Int32, Int32) 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 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.SiteMapNodePublic Overridable Function GetCurrentNodeAndHintNeighborhoodNodes (upLevel As Integer, downLevel As Integer) As SiteMapNodeParamè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 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
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 .
