Freigeben über


SiteMapProvider.GetParentNodeRelativeToNodeAndHintDownFromParent Methode

Definition

Stellt Siteübersichtsanbietern eine optimierte Nachschlagemethode zum Abrufen eines mittelbar übergeordneten Knotens für das angegebene SiteMapNode-Objekt und zum Abrufen der unmittelbar untergeordneten Knoten bereit.

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

Parameter

node
SiteMapNode

Der SiteMapNode, der als Bezugspunkt für walkupLevels und relativeDepthFromWalkup fungiert.

walkupLevels
Int32

Die beim Abrufen des angeforderten mittelbar übergeordneten Knotens zu durchlaufende Anzahl von Ebenen mittelbar übergeordneter Knoten.

relativeDepthFromWalkup
Int32

Die abzurufende Anzahl von Ebenen mittelbar untergeordneter Knoten aus dem mittelbar übergeordneten Zielknoten.

Gibt zurück

SiteMapNode

Ein SiteMapNode, der einen mittelbar übergeordneten Knoten von node darstellt. Andernfalls null, wenn der aktuelle oder mittelbar übergeordnete SiteMapNode nicht gefunden wird oder für den aktuellen Benutzer nicht zurückgegeben werden kann.

Ausnahmen

Der angegebene Wert für walkupLevels oder relativeDepthFromWalkup ist kleiner als 0 (null).

node ist null.

Hinweise

Die Standardimplementierung der SiteMapProvider Klasse bietet eine nicht optimierte Implementierung der Methode, das Aufrufen HintAncestorNodes der GetParentNodeRelativeToNodeAndHintDownFromParent Methoden und HintNeighborhoodNodes Methoden. Websitezuordnungsanbieter können die GetParentNodeRelativeToNodeAndHintDownFromParent Methode jedoch außer Kraft setzen und eine optimierte Implementierung bereitstellen, die benutzerdefinierte Zwischenspeicherungsmechanismen verwendet, um den Vorgängerknoten zurückzugeben und eine optimierte Nachschlagefunktion der anderen SiteMapNode Objekte auszuführen. Die GetParentNodeRelativeToNodeAndHintDownFromParent Methode ähnelt der GetParentNodeRelativeToCurrentNodeAndHintDownFromParent Methode sehr.

Der walkupLevels Parameter wird verwendet, um anzugeben, wie viele Ebenen übergeordneter und vorgängerknoten beim Abrufen des Zielknotens durchlaufen werden. Wenn weniger Ebenen vorhanden sind als angefordert, null wird sie zurückgegeben. Der downLevel Parameter wird verwendet, um anzugeben, wie viele Ebenen von absteigenden Knoten vom Ziel-Vorgängerknoten abgerufen werden sollen. Wenn dies bevorzugt wird, können die Vorgänger- und absteigenden Knoten mit der SiteMapNode GetParentNodeRelativeToNodeAndHintDownFromParent Methode verknüpft werden, wobei die ParentNode Eigenschaften verwendet ChildNodes werden. Wenn weniger Vorgängerknotenebenen vorhanden sind als durch den upLevel Parameter angegeben, null wird dieser zurückgegeben. Es liegt an der Anbieterimplementierer, um zu entscheiden, wie die Situation behandelt wird, in der die Anzahl der verfügbaren absteigenden Knotenebenen kleiner ist als der Wert, der vom downLevel Parameter angegeben wird.

Gilt für

Siehe auch