SiteMapProvider.HintNeighborhoodNodes(SiteMapNode, Int32, Int32) Metodo

Definizione

Specifica un metodo del quale i provider della mappa del sito possono eseguire l'override per un recupero ottimizzato dei nodi trovati in prossimità del nodo specificato.Provides a method that site map providers can override to perform an optimized retrieval of nodes found in the proximity of the specified node.

public:
 virtual void HintNeighborhoodNodes(System::Web::SiteMapNode ^ node, int upLevel, int downLevel);
public virtual void HintNeighborhoodNodes (System.Web.SiteMapNode node, int upLevel, int downLevel);
abstract member HintNeighborhoodNodes : System.Web.SiteMapNode * int * int -> unit
override this.HintNeighborhoodNodes : System.Web.SiteMapNode * int * int -> unit
Public Overridable Sub HintNeighborhoodNodes (node As SiteMapNode, upLevel As Integer, downLevel As Integer)

Parametri

node
SiteMapNode

Oggetto SiteMapNode che funzione da punto di riferimento per upLevel.The SiteMapNode that acts as a reference point for upLevel.

upLevel
Int32

Numero di generazioni dell'elemento SiteMapNode predecessore da recuperare.The number of ancestor SiteMapNode generations to fetch. 0 indica che non viene recuperato alcun nodo predecessore, mentre -1 indica la possibilità di recuperare tutti i predecessori (e i relativi nodi discendente fino al livello del node) e memorizzarli nella cache.0 indicates no ancestor nodes are retrieved and -1 indicates that all ancestors (and their descendant nodes to the level of node) might be retrieved and cached.

downLevel
Int32

Numero di generazioni dell'elemento SiteMapNode discendente da recuperare.The number of descendant SiteMapNode generations to fetch. 0 indica che non viene recuperato alcun nodo discendente, mentre -1 indica la possibilità di recuperare tutti i nodi discendente e di memorizzarli nella cache.0 indicates no descendant nodes are retrieved and -1 indicates that all descendant nodes might be retrieved and cached.

Eccezioni

upLevel o downLevel è minore di -1.upLevel or downLevel is less than -1.

node è null.node is null.

Commenti

Il metodo HintNeighborhoodNodes predefinito controlla solo la presenza upLevel di downLevel un parametro e che sia minore nulldi-1 node e un parametro.The default HintNeighborhoodNodes method only checks for an upLevel and downLevel parameters that are less than -1 and a node parameter that is null. Poiché l' XmlSiteMapProvider oggetto memorizza nella cache le informazioni sulla mappa del sito HintNeighborhoodNodes in memoria, il metodo non viene utilizzato.Because the XmlSiteMapProvider object caches site map information in memory, the HintNeighborhoodNodes method is not used.

I provider della mappa del sito HintNeighborhoodNodes possono eseguire l'override del metodo per eseguire SiteMapNode una ricerca ottimizzata degli oggetti in SiteMapNodeprossimità dell'oggetto specificato.Site map providers can override the HintNeighborhoodNodes method to perform an optimized lookup of the SiteMapNode objects in the proximity of the specified SiteMapNode. Il upLevel parametro viene usato per specificare il numero di livelli di nodi padre e predecessore da attraversare dall'oggetto SiteMapNodespecificato.The upLevel parameter is used to specify how many levels of parent and ancestor nodes to traverse from the specified SiteMapNode. Il downLevel parametro viene usato per specificare il numero di livelli dei nodi figlio del nodo corrente da recuperare.The downLevel parameter is used to specify how many levels of child nodes from the current node to retrieve. Se si preferisce, i nodi predecessore e discendente possono essere SiteMapNode collegati all'oggetto restituito HintNeighborhoodNodes dal metodo, usando le ParentNode proprietà ChildNodes e.If preferred, the ancestor and descendant nodes can be linked to the SiteMapNode that is returned by the HintNeighborhoodNodes method, using the ParentNode and ChildNodes properties.

Si applica a

Vedi anche