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 mapy lokacji podczas pobierania węzła ancestor 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.SiteMapNodePublic Overridable Function GetParentNodeRelativeToCurrentNodeAndHintDownFromParent (walkupLevels As Integer, relativeDepthFromWalkup As Integer) As SiteMapNodeParametry
- walkupLevels
- Int32
Liczba poziomów węzła ancestor do przechodzenia podczas pobierania żądanego węzła programu ancestor.
- relativeDepthFromWalkup
- Int32
Liczba poziomów węzłów podrzędnych do pobrania z węzła węzła docelowego.
Zwraca
Element reprezentujący SiteMapNode element nadrzędny aktualnie żądanej strony. W SiteMapNode przeciwnym razie , nulljeśli bieżący lub nadrzędny nie zostanie znaleziony lub SiteMapNode 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 nieoptymalizację implementacji metody , wywołując GetCurrentNodeAndHintAncestorNodes metody i. Jednak dostawcy map lokacji mogą zastąpić GetParentNodeRelativeToCurrentNodeAndHintDownFromParent metodę i HintNeighborhoodNodes zapewnić zoptymalizowaną implementacjęGetParentNodeRelativeToCurrentNodeAndHintDownFromParent, która używa niestandardowych mechanizmów buforowania, aby zwrócić węzeł ancestor i wykonać zoptymalizowane wyszukiwanie 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 mniej poziomów niż są żądane, null zostanie zwrócona. Parametr downLevel służy do określania liczby poziomów węzłów podrzędnych z węzła węzła docelowego do pobrania. Jeśli jest to preferowane, węzły ancestor 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 .
