SiteMapProvider.GetParentNodeRelativeToNodeAndHintDownFromParent Metodo

Definizione

Specifica un metodo di ricerca ottimizzato per i provider della mappa del sito quando si recupera un nodo predecessore per l'oggetto SiteMapNode specificato insieme ai relativi nodi figlio.

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

Parametri

node
SiteMapNode

Oggetto SiteMapNode che funziona da punto di riferimento per walkupLevels e relativeDepthFromWalkup.

walkupLevels
Int32

Numero di livelli di nodi predecessore da scorrere quando si recupera il nodo predecessore richiesto.

relativeDepthFromWalkup
Int32

Numero di livelli di nodi discendente da recuperare dal nodo predecessore di destinazione.

Restituisce

Elemento SiteMapNode che rappresenta un predecessore dell'elemento node; in caso contrario null, se l'elemento SiteMapNode corrente o predecessore non viene trovato o non può essere restituito per l'utente corrente.

Eccezioni

Il valore specificato per l'elemento walkupLevels o relativeDepthFromWalkup è minore di 0.

node è null.

Commenti

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

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 rispetto a 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 preferito, i nodi predecessori e discendenti possono essere collegati all'oggetto SiteMapNodeGetParentNodeRelativeToNodeAndHintDownFromParent restituito dal metodo, usando le ParentNode proprietà e ChildNodes . Se sono presenti meno livelli di nodo predecessore rispetto a quelli specificati dal upLevel parametro, null viene restituito. Il provider implementer decide come gestire la situazione in cui il numero di livelli di nodi discendenti disponibili è minore del valore specificato dal downLevel parametro.

Si applica a

Vedi anche