SiteMapProvider.HintNeighborhoodNodes(SiteMapNode, 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 que les fournisseurs de plan de site peuvent substituer pour exécuter une récupération optimisée des nœuds trouvés à proximité du nœud spécifié.
public:
virtual void HintNeighborhoodNodes(System::Web::SiteMapNode ^ node, int upLevel, int downLevel);public virtual void HintNeighborhoodNodes (System.Web.SiteMapNode node, int upLevel, int downLevel);abstract member HintNeighborhoodNodes : System.Web.SiteMapNode * int * int -> unit
override this.HintNeighborhoodNodes : System.Web.SiteMapNode * int * int -> unitPublic Overridable Sub HintNeighborhoodNodes (node As SiteMapNode, upLevel As Integer, downLevel 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 (et leurs nœuds descendants au niveau de node) peuvent être récupérés et mis en cache.
- downLevel
- Int32
Nombre de générations de SiteMapNode descendants à extraire. 0 indique qu'aucun nœud descendant n'est récupéré et -1 indique que tous les nœuds descendants peuvent être récupérés et mis en cache.
Exceptions
upLevel ou downLevel est inférieur à -1.
node a la valeur null.
Remarques
La méthode par défaut HintNeighborhoodNodes recherche uniquement un upLevel paramètre et downLevel des paramètres inférieurs à -1 et un node paramètre qui est null. Étant donné que l’objet XmlSiteMapProvider met en cache les informations de carte de site en mémoire, la HintNeighborhoodNodes méthode n’est pas utilisée.
Les fournisseurs de carte de site peuvent remplacer la HintNeighborhoodNodes méthode pour effectuer une recherche optimisée des SiteMapNode objets à proximité 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. Le downLevel paramètre est utilisé pour spécifier le nombre de niveaux de nœuds enfants du nœud actuel à récupérer. Si vous préférez, les nœuds ancêtres et descendants peuvent être liés à ceux SiteMapNode retournés par la méthode, à l’aide HintNeighborhoodNodes des propriétés et ChildNodes des ParentNode propriétés.