SiteMapProvider.GetParentNodeRelativeToCurrentNodeAndHintDownFromParent 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 die gerade angeforderte Seite und zum Abrufen der mittelbar untergeordneten Knoten für den übergeordneten Knoten bereit.
public:
virtual System::Web::SiteMapNode ^ GetParentNodeRelativeToCurrentNodeAndHintDownFromParent(int walkupLevels, int relativeDepthFromWalkup);public virtual System.Web.SiteMapNode GetParentNodeRelativeToCurrentNodeAndHintDownFromParent (int walkupLevels, int relativeDepthFromWalkup);abstract member GetParentNodeRelativeToCurrentNodeAndHintDownFromParent : int * int -> System.Web.SiteMapNode
override this.GetParentNodeRelativeToCurrentNodeAndHintDownFromParent : int * int -> System.Web.SiteMapNodePublic Overridable Function GetParentNodeRelativeToCurrentNodeAndHintDownFromParent (walkupLevels As Integer, relativeDepthFromWalkup As Integer) As SiteMapNodeParameter
- 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 SiteMapNode der gerade angeforderten Seite 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
walkupLevels oder relativeDepthFromWalkup ist kleiner als 0 (null).
Hinweise
Die Standardimplementierung der SiteMapProvider -Klasse bietet eine nicht optimierte Implementierung der GetParentNodeRelativeToCurrentNodeAndHintDownFromParent -Methode, die die GetCurrentNodeAndHintAncestorNodes Methoden und HintNeighborhoodNodes aufruft. Siteübersichtsanbieter können die GetParentNodeRelativeToCurrentNodeAndHintDownFromParent Methode jedoch überschreiben und eine optimierte Implementierung bereitstellen, die benutzerdefinierte Zwischenspeicherungsmechanismen verwendet, um den Vorgängerknoten zurückzugeben und eine optimierte Suche der anderen SiteMapNode Objekte durchzuführen.
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 werden, null wird zurückgegeben. Der downLevel -Parameter wird verwendet, um anzugeben, wie viele Ebenen von Nachfolgerknoten vom Zielknoten des Vorgängerknotens abgerufen werden sollen. Bei Bedarf können die Vorgänger- und Nachfolgerknoten mit dem verknüpft werden, der SiteMapNode von der -Methode mithilfe der GetParentNodeRelativeToCurrentNodeAndHintDownFromParentParentNode Eigenschaften und ChildNodes zurückgegeben wird.
