SiteMapProvider.HintAncestorNodes(SiteMapNode, 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 que les fournisseurs de plan de site peuvent substituer pour exécuter une récupération optimisée d'un ou plusieurs niveaux de nœuds parents et ancêtres relatifs à l'objet SiteMapNode spécifié.
public:
virtual void HintAncestorNodes(System::Web::SiteMapNode ^ node, int upLevel);public virtual void HintAncestorNodes (System.Web.SiteMapNode node, int upLevel);abstract member HintAncestorNodes : System.Web.SiteMapNode * int -> unit
override this.HintAncestorNodes : System.Web.SiteMapNode * int -> unitPublic Overridable Sub HintAncestorNodes (node As SiteMapNode, upLevel As Integer)Paramètres
- node
- SiteMapNode
SiteMapNode qui agit en tant que point de référence pour upLevel.
- 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 tous les ancêtres peuvent être récupérés et mis en cache.
Exceptions
upLevel est inférieur à -1.
node a la valeur null.
Remarques
La méthode par défaut HintAncestorNodes recherche uniquement un upLevel paramètre inférieur à -1 et un node paramètre qui est null. Étant donné que la XmlSiteMapProvider classe met en cache les informations de carte de site en mémoire, la HintAncestorNodes méthode n’est pas utilisée.
Les fournisseurs de carte de site peuvent remplacer la HintAncestorNodes méthode pour effectuer une récupération optimisée des nœuds parent et ancêtres de l’objet spécifié SiteMapNode .
Le upLevel paramètre est utilisé pour spécifier le nombre de niveaux de nœuds parent et ancêtres à parcourir à partir de l’élément spécifié SiteMapNode. Si moins de niveaux existent que ceux demandés, tous les nœuds ancêtres disponibles sont retournés dans la limite spécifiée. Si vous préférez, le nœud parent peut être lié à l’utilisation de la ParentNode propriété spécifiéeSiteMapNode.