SiteMapProvider.GetCurrentNodeAndHintAncestorNodes(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 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.SiteMapNodePublic Overridable Function GetCurrentNodeAndHintAncestorNodes (upLevel As Integer) As SiteMapNodeParametri
- 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
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.