SiteMapProvider.HintNeighborhoodNodes(SiteMapNode, Int32, Int32) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Specifica un metodo del quale i provider della mappa del sito possono eseguire l'override per un recupero ottimizzato dei nodi trovati in prossimità del nodo specificato.
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)Parametri
- node
- SiteMapNode
Oggetto SiteMapNode che funzione da punto di riferimento per upLevel.
- upLevel
- Int32
Numero di generazioni dell'elemento SiteMapNode predecessore da recuperare. 0 indica che non viene recuperato alcun nodo predecessore, mentre -1 indica la possibilità di recuperare tutti i predecessori (e i relativi nodi discendente fino al livello del node) e memorizzarli nella cache.
- downLevel
- Int32
Numero di generazioni dell'elemento SiteMapNode discendente da recuperare. 0 indica che non viene recuperato alcun nodo discendente, mentre -1 indica la possibilità di recuperare tutti i nodi discendente e di memorizzarli nella cache.
Eccezioni
upLevel o downLevel è minore di -1.
node è null.
Commenti
Il metodo predefinito HintNeighborhoodNodes controlla upLevel solo i parametri e downLevel minori di -1 e un node parametro che è null. Poiché l'oggetto memorizza nella cache le informazioni sulla mappa del XmlSiteMapProvider sito in memoria, il HintNeighborhoodNodes metodo non viene usato.
I provider di mappe del sito possono eseguire l'override del HintNeighborhoodNodes metodo per eseguire una ricerca ottimizzata degli SiteMapNode oggetti nella prossimità dell'oggetto specificato SiteMapNode. Il upLevel parametro viene usato per specificare il numero di livelli di nodi padre e predecessore da attraversare dall'oggetto specificato SiteMapNode. Il downLevel parametro viene usato per specificare il numero di livelli di nodi figlio dal nodo corrente da recuperare. Se preferito, i nodi predecessori e discendenti possono essere collegati all'oggetto SiteMapNodeHintNeighborhoodNodes restituito dal metodo, usando le ParentNode proprietà e ChildNodes .
