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.Provides an optimized lookup method for site map providers when retrieving the node for the currently requested page and fetching the parent and ancestor site map nodes for the current page.

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.The number of ancestor site map node generations to get. Un valore -1 indica che il provider può recuperare tutti i predecessori e memorizzarli nella cache.A value of -1 indicates that all ancestors might be retrieved and cached by the provider.

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.A SiteMapNode that represents the currently requested page; otherwise, null, if the SiteMapNode is not found or cannot be returned for the current user.

Eccezioni

upLevel è minore di -1.upLevel is less than -1.

Commenti

L'implementazione predefinita del metodo GetCurrentNodeAndHintAncestorNodes restituisce la proprietà CurrentNode. Tuttavia, i provider della mappa del sito possono eseguire l'override del metodo GetCurrentNodeAndHintAncestorNodes e fornire un'implementazione ottimizzata che usa meccanismi di memorizzazione nella cache personalizzati per restituire la SiteMapNodecorrente, nonché i nodi padre e predecessore dell'elemento padre.The default implementation of the GetCurrentNodeAndHintAncestorNodes method returns the CurrentNode property; however, site map providers can override the GetCurrentNodeAndHintAncestorNodes method and provide an optimized implementation that uses custom caching mechanisms to return the current SiteMapNode, as well as the parent and ancestor nodes of the parent.

Il parametro upLevel viene usato per specificare il numero di livelli di nodi padre e predecessore da recuperare.The upLevel parameter is used to specify how many levels of parent and ancestor nodes to retrieve. Se si preferisce, i nodi padre e predecessore possono essere collegati all'oggetto SiteMapNode restituito dal metodo GetCurrentNodeAndHintAncestorNodes, usando la proprietà ParentNode.If preferred, the parent and ancestor nodes can be linked to the SiteMapNode object that is returned by the GetCurrentNodeAndHintAncestorNodes method, using the ParentNode property.

La classe XmlSiteMapProvider, che è il provider della mappa del sito predefinito per ASP.NET, memorizza nella cache l'intera mappa del sito in memoria, il che comporta un sovraccarico minimo o minimo quando si eseguono query sui XmlSiteMapProvider per oggetti SiteMapNode specifici.The XmlSiteMapProvider class, which is the default site map provider for ASP.NET, caches the entire site map in memory, which results in little or no overhead when querying the XmlSiteMapProvider for specific SiteMapNode objects.

Si applica a

Vedi anche