SiteMapProvider.GetParentNodeRelativeToCurrentNodeAndHintDownFromParent Metoda

Definicja

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

Parametry

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 .

Dotyczy

Zobacz też