Condividi tramite


SiteMapProvider.HintAncestorNodes(SiteMapNode, Int32) Metodo

Definizione

Specifica un metodo del quale i provider della mappa del sito possono eseguire l'override per un recupero ottimizzato di uno o più livelli di nodi padre e predecessore, in relazione all'oggetto SiteMapNode specificato.

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)

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 memorizzarli nella cache.

Eccezioni

upLevel è minore di -1.

node è null.

Commenti

Il metodo predefinito HintAncestorNodes controlla solo la presenza di un upLevel parametro minore di -1 e di un node parametro che è null. Poiché la classe memorizza nella cache le XmlSiteMapProvider informazioni sulla mappa del sito in memoria, il HintAncestorNodes metodo non viene usato.

I provider della mappa del sito possono eseguire l'override del HintAncestorNodes metodo per eseguire un recupero ottimizzato di nodi padre e predecessore 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. Se sono presenti meno livelli rispetto a quelli richiesti, tutti i nodi predecessori disponibili vengono restituiti all'interno del limite specificato. Se preferito, il nodo padre può essere collegato all'oggetto specificato SiteMapNode usando la ParentNode proprietà .

Si applica a

Vedi anche