Udostępnij za pośrednictwem


SiteMapProvider.GetParentNodeRelativeToNodeAndHintDownFromParent Metoda

Definicja

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

Parametry

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

SiteMapNode

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 .

Dotyczy

Zobacz też