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 eine optimierte Nachschlagemethode für Websitezuordnungsanbieter bereit, wenn ein übergeordneter Knoten für das angegebene SiteMapNode Objekt abgerufen und seine untergeordneten Knoten abgerufen werden.
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
Das SiteMapNode dient als Referenzpunkt für walkupLevels und relativeDepthFromWalkup.
- walkupLevels
- Int32
Die Anzahl der Vorgängerknotenebenen, die beim Abrufen des angeforderten Vorgängerknotens durchlaufen werden sollen.
- relativeDepthFromWalkup
- Int32
Die Anzahl der untergeordneten Knotenebenen, die vom Ziel-Vorgängerknoten abgerufen werden sollen.
Gibt zurück
A SiteMapNode , das ein Vorgänger von node; andernfalls, nullwenn der aktuelle oder Vorgänger SiteMapNode nicht gefunden oder für den aktuellen Benutzer nicht zurückgegeben werden kann.
Ausnahmen
Der für oder walkupLevels kleiner als 0 angegebene relativeDepthFromWalkup Wert.
node ist null.
Hinweise
Die Standardimplementierung der SiteMapProvider Klasse bietet eine nicht optimierte Implementierung der Methode, das Aufrufen der GetParentNodeRelativeToNodeAndHintDownFromParentHintAncestorNodes 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 übergeordneten Knoten zurückzugeben und eine optimierte Suche der anderen SiteMapNode Objekte durchzuführen. Die GetParentNodeRelativeToNodeAndHintDownFromParent Methode ist der Methode sehr ähnlich GetParentNodeRelativeToCurrentNodeAndHintDownFromParent .
Der walkupLevels Parameter wird verwendet, um anzugeben, wie viele Ebenen von übergeordneten und übergeordneten Knoten beim Abrufen des Zielknotens durchlaufen werden sollen. Wenn weniger Ebenen vorhanden sind als angefordert, null wird diese zurückgegeben. Der downLevel Parameter wird verwendet, um anzugeben, wie viele Ebenen von untergeordneten Knoten vom Ziel-Vorgängerknoten abgerufen werden sollen. Wenn bevorzugt, können die untergeordneten und untergeordneten Knoten mit dem SiteMapNode von der GetParentNodeRelativeToNodeAndHintDownFromParent Methode zurückgegebenen Knoten verknüpft werden, wobei die ParentNode Eigenschaften verwendet ChildNodes werden. Wenn weniger Vorgängerknotenebenen vorhanden sind als durch den upLevel Parameter angegeben, null wird diese zurückgegeben. Es liegt bei der Anbieterimplementierer, zu entscheiden, wie die Situation behandelt wird, in der die Anzahl der verfügbaren untergeordneten Knotenebenen kleiner als der wert ist, der downLevel vom Parameter angegeben wird.
