SiteMapProvider.GetCurrentNodeAndHintNeighborhoodNodes(Int32, Int32) Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Web
Assembly:
System.Web.dll

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.SiteMapNode
Public Overridable Function GetCurrentNodeAndHintNeighborhoodNodes (upLevel As Integer, downLevel As Integer) As SiteMapNode

Parametri

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

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

ArgumentOutOfRangeException

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 .

Si applica a

Vedi anche