SiteMapProvider.GetParentNodeRelativeToCurrentNodeAndHintDownFromParent Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Udostępnia zoptymalizowaną metodę wyszukiwania dla dostawców map lokacji podczas pobierania węzła węzła węzła przodka dla aktualnie żądanej strony i pobierania węzłów podrzędnych dla obiektu ancestor.
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
Parametry
- walkupLevels
- Int32
Liczba poziomów węzła węzła przodka, które mają być przechodzenia podczas pobierania żądanego węzła węzła przodka.
- relativeDepthFromWalkup
- Int32
Liczba poziomów węzłów podrzędnych do pobrania z węzła docelowego przodka.
Zwraca
Element SiteMapNode reprezentujący przodka SiteMapNode aktualnie żądanej strony. W przeciwnym razie null, jeśli bieżący lub nadrzędny SiteMapNode nie został znaleziony lub nie można go zwrócić dla bieżącego użytkownika.
Wyjątki
walkupLevels lub relativeDepthFromWalkup jest mniejszy niż 0.
Uwagi
Domyślna implementacja SiteMapProvider klasy zapewnia nieoptymalizaną implementację GetParentNodeRelativeToCurrentNodeAndHintDownFromParent metody , wywołując GetCurrentNodeAndHintAncestorNodes metody i HintNeighborhoodNodes . Jednak dostawcy map lokacji mogą zastąpić GetParentNodeRelativeToCurrentNodeAndHintDownFromParent metodę i zapewnić zoptymalizowaną implementację, która używa niestandardowych mechanizmów buforowania w celu zwrócenia węzła przodka i wykonania zoptymalizowanego wyszukiwania innych SiteMapNode obiektów.
Parametr walkupLevels służy do określania liczby poziomów węzłów nadrzędnych i węzłów nadrzędnych do przechodzenia podczas pobierania węzła docelowego. Jeśli istnieje mniejsza liczba poziomów niż są wymagane, null zwracana jest wartość . Parametr downLevel służy do określania, ile poziomów węzłów podrzędnych należy pobrać z węzła węzła docelowego. Jeśli jest to preferowane, węzły podrzędne i węzły podrzędne mogą być połączone SiteMapNode z obiektem zwracanym przez metodę GetParentNodeRelativeToCurrentNodeAndHintDownFromParent przy użyciu ParentNode właściwości i ChildNodes .