SiteMapProvider.GetCurrentNodeAndHintAncestorNodes(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 pour les 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 des nœuds de plan de site parents et ancêtres de la page actuelle.
public:
virtual System::Web::SiteMapNode ^ GetCurrentNodeAndHintAncestorNodes(int upLevel);public virtual System.Web.SiteMapNode GetCurrentNodeAndHintAncestorNodes (int upLevel);abstract member GetCurrentNodeAndHintAncestorNodes : int -> System.Web.SiteMapNode
override this.GetCurrentNodeAndHintAncestorNodes : int -> System.Web.SiteMapNodePublic Overridable Function GetCurrentNodeAndHintAncestorNodes (upLevel As Integer) As SiteMapNodeParamètres
- upLevel
- Int32
Nombre de générations du nœud de plan de site ancêtre à récupérer. Une valeur de -1 indique que le fournisseur peut récupérer et mettre en cache tous les ancêtres.
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 est inférieur à -1.
Remarques
L’implémentation par défaut de la GetCurrentNodeAndHintAncestorNodes méthode retourne la CurrentNode propriété ; toutefois, les fournisseurs de carte de site peuvent remplacer la GetCurrentNodeAndHintAncestorNodes méthode et fournir une implémentation optimisée qui utilise des mécanismes de mise en cache personnalisés pour retourner le courant SiteMapNode, ainsi que les nœuds parent et ancêtres du parent.
Le upLevel paramètre est utilisé pour spécifier le nombre de niveaux de nœuds parents et ancêtres à récupérer. Si vous préférez, les nœuds parent et ancêtres peuvent être liés à l’objet SiteMapNode retourné par la méthode, à l’aide GetCurrentNodeAndHintAncestorNodes de la ParentNode propriété.
La XmlSiteMapProvider classe, qui est le fournisseur de carte de site par défaut pour ASP.NET, met en cache la carte de site entière en mémoire, ce qui entraîne peu ou pas de surcharge lors de l’interrogation des XmlSiteMapProvider objets spécifiquesSiteMapNode.