SiteMapProvider.HintNeighborhoodNodes(SiteMapNode, Int32, Int32) Metodo

Definizione

Spazio dei nomi:

System.Web

Assembly:

System.Web.dll

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

Public 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

ArgumentOutOfRangeException

upLevel o downLevel è minore di -1.

ArgumentNullException

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 .

Vedi anche

• HintAncestorNodes(SiteMapNode, Int32)