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

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 GetCurrentNodeAndHintAncestorNodes metodo restituisce la CurrentNode proprietà. Tuttavia, i provider della mappa del sito possono GetCurrentNodeAndHintAncestorNodes eseguire l'override del 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.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 upLevel parametro 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 SiteMapNode all'oggetto restituito GetCurrentNodeAndHintAncestorNodes dal metodo, usando la ParentNode proprietà.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 XmlSiteMapProvider classe, 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 XmlSiteMapProvider minimo quando SiteMapNode si eseguono query su oggetti 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