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.
Fornisce un metodo che i provider di mapping del sito possono eseguire l'override per eseguire 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 funge da punto di riferimento per upLevel.
- upLevel
- Int32
Numero di generazioni predecessori SiteMapNode da recuperare. 0 indica che non vengono recuperati nodi predecessori e -1 indica che tutti i predecessori (e i relativi nodi discendenti al livello di node) potrebbero essere recuperati e memorizzati nella cache.
- downLevel
- Int32
Numero di generazioni discendenti SiteMapNode da recuperare. 0 indica che non vengono recuperati nodi discendenti e -1 indica che tutti i nodi discendenti potrebbero essere recuperati e memorizzati nella cache.
Eccezioni
upLevel o downLevel è minore di -1.
node è null.
Commenti
Il metodo predefinito HintNeighborhoodNodes controlla solo la presenza di parametri upLevel e downLevel minori di -1 e di un node parametro che è null. Poiché l'oggetto memorizza nella cache le informazioni della XmlSiteMapProvider mappa del sito in memoria, il HintNeighborhoodNodes metodo non viene utilizzato.
I provider della mappa del sito possono eseguire l'override del HintNeighborhoodNodes metodo per eseguire una ricerca ottimizzata degli SiteMapNode oggetti in 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 si preferisce, i nodi predecessore e discendente possono essere collegati all'oggetto SiteMapNode restituito dal HintNeighborhoodNodes metodo , usando le ParentNode proprietà e ChildNodes .
