SiteMapProvider.GetCurrentNodeAndHintNeighborhoodNodes(Int32, Int32) 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 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.SiteMapNodePublic Overridable Function GetCurrentNodeAndHintNeighborhoodNodes (upLevel As Integer, downLevel As Integer) As SiteMapNodeParametry
- 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
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
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.
