Freigeben über


SiteMapProvider.GetParentNodeRelativeToCurrentNodeAndHintDownFromParent Methode

Definition

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.SiteMapNode
Public Overridable Function GetParentNodeRelativeToCurrentNodeAndHintDownFromParent (walkupLevels As Integer, relativeDepthFromWalkup As Integer) As SiteMapNode

Parameter

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.

Gilt für:

Weitere Informationen