SiteMapProvider.HintAncestorNodes(SiteMapNode, 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 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 -> unitPublic 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à .