SiteMapProvider.GetParentNodeRelativeToCurrentNodeAndHintDownFromParent Metodo

Definizione

Fornisce un metodo di ricerca ottimizzato per i provider di mappe del sito durante il recupero di un nodo predecessore per la pagina attualmente richiesta e il recupero dei nodi discendenti per il predecessore.

public:
 virtual System::Web::SiteMapNode ^ GetParentNodeRelativeToCurrentNodeAndHintDownFromParent(int walkupLevels, int relativeDepthFromWalkup);
public virtual System.Web.SiteMapNode GetParentNodeRelativeToCurrentNodeAndHintDownFromParent(int walkupLevels, int relativeDepthFromWalkup);
abstract member GetParentNodeRelativeToCurrentNodeAndHintDownFromParent : int * int -> System.Web.SiteMapNode
override this.GetParentNodeRelativeToCurrentNodeAndHintDownFromParent : int * int -> System.Web.SiteMapNode
Public Overridable Function GetParentNodeRelativeToCurrentNodeAndHintDownFromParent (walkupLevels As Integer, relativeDepthFromWalkup As Integer) As SiteMapNode

Parametri

walkupLevels
Int32

Numero di livelli di nodo predecessore da attraversare durante il recupero del nodo predecessore richiesto.

relativeDepthFromWalkup
Int32

Numero di livelli di nodo discendenti da recuperare dal nodo predecessore di destinazione.

Valori restituiti

Oggetto SiteMapNode che rappresenta un predecessore SiteMapNode della pagina attualmente richiesta; in caso contrario, , nullse l'oggetto corrente o predecessore SiteMapNode non viene trovato o non può essere restituito per l'utente corrente.

Eccezioni

walkupLevels o relativeDepthFromWalkup è minore di 0.

Commenti

L'implementazione predefinita della SiteMapProvider classe fornisce un'implementazione non ottimizzata del GetParentNodeRelativeToCurrentNodeAndHintDownFromParent metodo , chiamando i metodi e GetCurrentNodeAndHintAncestorNodes . Tuttavia, i HintNeighborhoodNodes provider della mappa del sito possono eseguire l'override del GetParentNodeRelativeToCurrentNodeAndHintDownFromParent metodo e fornire un'implementazione ottimizzata che usa meccanismi di memorizzazione nella cache personalizzati per restituire il nodo predecessore ed eseguire una ricerca ottimizzata degli altri SiteMapNode oggetti.

Il walkupLevels parametro viene usato per specificare il numero di livelli di nodi padre e predecessore da attraversare durante il recupero del nodo di destinazione. Se sono presenti meno livelli di quelli richiesti, null viene restituito . Il downLevel parametro viene usato per specificare il numero di livelli di nodi discendenti dal nodo predecessore di destinazione da recuperare. Se si preferisce, i nodi predecessore e discendente possono essere collegati all'oggetto SiteMapNode restituito dal GetParentNodeRelativeToCurrentNodeAndHintDownFromParent metodo , usando le ParentNode proprietà e ChildNodes .

Si applica a

Vedi anche