SiteMapProvider.GetParentNodeRelativeToNodeAndHintDownFromParent Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.SiteMapNodePublic Overridable Function GetParentNodeRelativeToNodeAndHintDownFromParent (node As SiteMapNode, walkupLevels As Integer, relativeDepthFromWalkup As Integer) As SiteMapNodeParameter
- 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
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.