Partager via


SiteMapProvider.HintAncestorNodes(SiteMapNode, Int32) Méthode

Définition

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 -> unit
Public 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.

S’applique à

Voir aussi