SiteMapProvider.HintNeighborhoodNodes(SiteMapNode, 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.
Zapewnia metodę, którą dostawcy mapy lokacji mogą zastąpić w celu przeprowadzenia zoptymalizowanego pobierania węzłów znajdujących się w pobliżu określonego węzła.
public:
virtual void HintNeighborhoodNodes(System::Web::SiteMapNode ^ node, int upLevel, int downLevel);public virtual void HintNeighborhoodNodes (System.Web.SiteMapNode node, int upLevel, int downLevel);abstract member HintNeighborhoodNodes : System.Web.SiteMapNode * int * int -> unit
override this.HintNeighborhoodNodes : System.Web.SiteMapNode * int * int -> unitPublic Overridable Sub HintNeighborhoodNodes (node As SiteMapNode, upLevel As Integer, downLevel As Integer)Parametry
- node
- SiteMapNode
To SiteMapNode działa jako punkt odniesienia dla upLevel.
- upLevel
- Int32
Liczba pokoleń ancestora SiteMapNode do pobrania. 0 wskazuje, że nie są pobierane węzły ancestor, a -1 wskazuje, że wszystkie węzły podrzędne (i ich węzły podrzędne na poziomie node) mogą być pobierane i buforowane.
- downLevel
- Int32
Liczba pokoleń potomnych SiteMapNode do pobrania. 0 wskazuje, że nie są pobierane węzły podrzędne, a -1 wskazuje, że wszystkie węzły podrzędne mogą być pobierane i buforowane.
Wyjątki
upLevel lub downLevel jest mniejszy niż -1.
node to null.
Uwagi
Metoda domyślna HintNeighborhoodNodes sprawdza upLevel tylko parametry i downLevel , które są mniejsze niż -1 i node parametr, który jest null. XmlSiteMapProvider Ponieważ obiekt buforuje informacje o mapie lokacji w pamięci, HintNeighborhoodNodes metoda nie jest używana.
Dostawcy mapy lokacji mogą zastąpić metodę HintNeighborhoodNodes w celu przeprowadzenia zoptymalizowanego wyszukiwania SiteMapNode obiektów w pobliżu określonego SiteMapNodeobiektu . Parametr upLevel służy do określania, ile poziomów węzłów nadrzędnych i węzłów nadrzędnych ma przechodzić z określonego SiteMapNodeelementu . Parametr downLevel służy do określania liczby poziomów węzłów podrzędnych z bieżącego węzła 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ę HintNeighborhoodNodes , przy użyciu ParentNode właściwości i ChildNodes .