SiteMapProvider.GetCurrentNodeAndHintNeighborhoodNodes(Int32, Int32) Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web
Zestaw:
System.Web.dll

Udostępnia zoptymalizowaną metodę wyszukiwania dla dostawców mapy lokacji podczas pobierania węzła dla aktualnie żądanej strony i pobierania węzłów mapy witryny w pobliżu bieżącego węzła.

public:
 virtual System::Web::SiteMapNode ^ GetCurrentNodeAndHintNeighborhoodNodes(int upLevel, int downLevel);
public virtual System.Web.SiteMapNode GetCurrentNodeAndHintNeighborhoodNodes (int upLevel, int downLevel);
abstract member GetCurrentNodeAndHintNeighborhoodNodes : int * int -> System.Web.SiteMapNode
override this.GetCurrentNodeAndHintNeighborhoodNodes : int * int -> System.Web.SiteMapNode
Public Overridable Function GetCurrentNodeAndHintNeighborhoodNodes (upLevel As Integer, downLevel As Integer) As SiteMapNode

Parametry

upLevel
Int32

Liczba pokoleń przodków SiteMapNode do pobrania. Wartość 0 wskazuje, że nie pobrano węzłów nadrzędnych, a -1 wskazuje, że wszystkie elementy nadrzędnych mogą być pobierane i buforowane przez dostawcę.

downLevel
Int32

Liczba pokoleń podrzędnych SiteMapNode do pobrania. 0 wskazuje, że nie są pobierane żadne węzły podrzędne, a parametr -1 wskazuje, że wszystkie węzły podrzędne mogą być pobierane i buforowane przez dostawcę.

Zwraca

SiteMapNode

Element reprezentujący aktualnie żądaną stronę. W SiteMapNode przeciwnym razie , nulljeśli SiteMapNode element nie został znaleziony lub nie można go zwrócić dla bieżącego użytkownika.

Wyjątki

ArgumentOutOfRangeException

upLevel wartość lub downLevel jest mniejsza niż -1.

Uwagi

Domyślna implementacja GetCurrentNodeAndHintNeighborhoodNodes metody zwraca CurrentNode właściwość , jednak dostawcy mapy witryny mogą zastąpić GetCurrentNodeAndHintNeighborhoodNodes metodę i zapewnić zoptymalizowaną implementację, która używa niestandardowych mechanizmów buforowania w celu zwrócenia bieżącego SiteMapNode obiektu, a także SiteMapNode obiektów znajdujących się w pobliżu bieżącego SiteMapNodeobiektu .

Parametr upLevel służy do określania liczby poziomów węzłów nadrzędnych i węzłów nadrzędnych do pobrania i buforowania wraz z ich bezpośrednimi elementami podrzędnymi. Parametr downLevel służy do określania liczby poziomów węzłów podrzędnych z bieżącego SiteMapNode do pobrania. Jeśli jest to preferowane, węzły podrzędne i węzły podrzędne mogą być połączone z SiteMapNode węzłem zwracanym przez element

GetCurrentNodeAndHintNeighborhoodNodes metoda przy użyciu ParentNode właściwości i ChildNodes . Jeśli istnieje mniej poziomów węzłów nadrzędnych lub podrzędnych niż są określone przez upLevel lub downLevel, są pobierane tylko te, które są dostępne.

Klasa XmlSiteMapProvider , która jest domyślnym dostawcą mapy witryny dla ASP.NET, buforuje całą mapę witryny w pamięci, co powoduje niewielkie lub niewielkie obciążenie podczas wykonywania zapytań XmlSiteMapProvider dotyczących określonych SiteMapNode obiektów.

Dotyczy

Zobacz też