SiteMapProvider.GetParentNodeRelativeToNodeAndHintDownFromParent Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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.SiteMapNodePublic Overridable Function GetParentNodeRelativeToNodeAndHintDownFromParent (node As SiteMapNode, walkupLevels As Integer, relativeDepthFromWalkup As Integer) As SiteMapNodeParametri
- 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.
