SiteMapProvider.GetCurrentNodeAndHintNeighborhoodNodes(Int32, 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 della mappa del sito in prossimità del nodo corrente.
public:
virtual System::Web::SiteMapNode ^ GetCurrentNodeAndHintNeighborhoodNodes(int upLevel, int downLevel);public virtual System.Web.SiteMapNode GetCurrentNodeAndHintNeighborhoodNodes (int upLevel, int downLevel);abstract member GetCurrentNodeAndHintNeighborhoodNodes : int * int -> System.Web.SiteMapNode
override this.GetCurrentNodeAndHintNeighborhoodNodes : int * int -> System.Web.SiteMapNodePublic Overridable Function GetCurrentNodeAndHintNeighborhoodNodes (upLevel As Integer, downLevel As Integer) As SiteMapNodeParametri
- 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à che il provider recuperi tutti i predecessori e li memorizzi nella cache.
- downLevel
- Int32
Numero di generazioni dell'elemento SiteMapNode figlio da recuperare. 0 indica che non viene recuperato alcun nodo discendente, mentre -1 indica la possibilità per il provider di recuperare tutti i nodi discendente e di 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 o downLevel è minore di -1.
Commenti
L'implementazione predefinita del metodo restituisce la proprietà. Tuttavia, i provider di GetCurrentNodeAndHintNeighborhoodNodes mappe del sito possono eseguire l'override del metodo e fornire un'implementazione GetCurrentNodeAndHintNeighborhoodNodes ottimizzata che usa meccanismi di memorizzazione nella cache personalizzati per restituire l'oggetto corrente, nonché SiteMapNode gli oggetti che si trovano nella prossimità dell'oggetto correnteSiteMapNodeSiteMapNode.CurrentNode
Il upLevel parametro viene usato per specificare il numero di livelli di nodi padre e predecessori da recuperare e memorizzare nella cache, insieme ai relativi figli immediati. Il downLevel parametro viene usato per specificare il numero di livelli di nodi discendenti dall'oggetto corrente SiteMapNode da recuperare. Se preferito, i nodi predecessori e discendenti possono essere collegati all'oggetto SiteMapNode restituito dal
GetCurrentNodeAndHintNeighborhoodNodes metodo, usando le ParentNode proprietà e ChildNodes . Se sono presenti meno livelli di predecessore o di nodi figlio specificati da upLevel o downLevel, vengono recuperati solo quelli disponibili.
La XmlSiteMapProvider classe, che è il provider predefinito della mappa del sito per ASP.NET, memorizza nella cache l'intera mappa del sito in memoria, che comporta un sovraccarico minimo o nessun sovraccarico quando si esegue una query su XmlSiteMapProvider per oggetti specifici SiteMapNode .
