Condividi tramite


SiteMapProvider.GetCurrentNodeAndHintAncestorNodes(Int32) Metodo

Definizione

Specifica un metodo di ricerca ottimizzato per i provider della mappa del sito al momento del recupero del nodo per la pagina richiesta attualmente e dei nodi padre e predecessore per la mappa del sito per la pagina corrente.

public:
 virtual System::Web::SiteMapNode ^ GetCurrentNodeAndHintAncestorNodes(int upLevel);
public virtual System.Web.SiteMapNode GetCurrentNodeAndHintAncestorNodes (int upLevel);
abstract member GetCurrentNodeAndHintAncestorNodes : int -> System.Web.SiteMapNode
override this.GetCurrentNodeAndHintAncestorNodes : int -> System.Web.SiteMapNode
Public Overridable Function GetCurrentNodeAndHintAncestorNodes (upLevel As Integer) As SiteMapNode

Parametri

upLevel
Int32

Numero delle generazioni dei nodi predecessori della mappa del sito da ottenere. Un valore -1 indica che il provider può recuperare tutti i predecessori e memorizzarli nella cache.

Restituisce

SiteMapNode

Elemento SiteMapNode che rappresenta la pagina attualmente richiesta; in caso contrario null se l'elemento SiteMapNode non viene trovato oppure non può essere restituito per l'utente corrente.

Eccezioni

upLevel è minore di -1.

Commenti

L'implementazione predefinita del GetCurrentNodeAndHintAncestorNodes metodo restituisce la CurrentNode proprietà . Tuttavia, i provider della mappa del sito possono eseguire l'override del GetCurrentNodeAndHintAncestorNodes metodo e fornire un'implementazione ottimizzata che usa meccanismi di memorizzazione nella cache personalizzati per restituire l'oggetto corrente SiteMapNode, nonché i nodi padre e predecessore dell'elemento padre.

Il upLevel parametro viene usato per specificare il numero di livelli di nodi padre e predecessore da recuperare. Se si preferisce, i nodi padre e predecessore possono essere collegati all'oggetto SiteMapNode restituito dal GetCurrentNodeAndHintAncestorNodes metodo utilizzando la ParentNode proprietà .

La XmlSiteMapProvider classe , ovvero il provider predefinito della mappa del sito per ASP.NET, memorizza nella cache l'intera mappa del sito in memoria, con un sovraccarico minimo o nullo durante l'esecuzione XmlSiteMapProvider di query su per oggetti specificiSiteMapNode.

Si applica a

Vedi anche