SiteMapProvider.GetParentNodeRelativeToNodeAndHintDownFromParent 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 podrzędnego dla określonego SiteMapNode obiektu i pobierania jego węzłów podrzędnych.
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 SiteMapNodeParametry
- node
- SiteMapNode
To SiteMapNode działa jako punkt odniesienia dla walkupLevels i relativeDepthFromWalkup.
- 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 SiteMapNode reprezentujący element nodenadrzędny ; w przeciwnym razie , nulljeśli bieżący lub nadrzędny SiteMapNode nie zostanie znaleziony lub nie można go zwrócić dla bieżącego użytkownika.
Wyjątki
Wartość określona dla walkupLevels wartości lub relativeDepthFromWalkup jest mniejsza niż 0.
node to null.
Uwagi
Domyślna implementacja SiteMapProvider klasy zapewnia nieoptymalizację implementacji metody , wywołując HintAncestorNodes metody i. Jednak dostawcy map lokacji mogą zastąpić GetParentNodeRelativeToNodeAndHintDownFromParent metodę i HintNeighborhoodNodes zapewnić zoptymalizowaną implementacjęGetParentNodeRelativeToNodeAndHintDownFromParent, która używa niestandardowych mechanizmów buforowania, aby zwrócić węzeł ancestor i wykonać zoptymalizowane wyszukiwanie innych SiteMapNode obiektów. Metoda jest bardzo podobna GetParentNodeRelativeToNodeAndHintDownFromParent GetParentNodeRelativeToCurrentNodeAndHintDownFromParent do metody .
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ę GetParentNodeRelativeToNodeAndHintDownFromParent , przy użyciu ParentNode właściwości i ChildNodes . Jeśli istnieje mniej poziomów węzła węzła niż określony przez upLevel parametr, null jest zwracany. Do implementatora dostawcy należy zdecydować, jak obsługiwać sytuację, w której liczba dostępnych poziomów węzłów podrzędnych jest mniejsza niż wartość określona przez downLevel parametr .