SiteMapProvider.GetCurrentNodeAndHintAncestorNodes(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 nadrzędnej i węzłów mapy lokacji programu ancestor dla bieżącej strony.
public:
virtual System::Web::SiteMapNode ^ GetCurrentNodeAndHintAncestorNodes(int upLevel);public virtual System.Web.SiteMapNode GetCurrentNodeAndHintAncestorNodes (int upLevel);abstract member GetCurrentNodeAndHintAncestorNodes : int -> System.Web.SiteMapNode
override this.GetCurrentNodeAndHintAncestorNodes : int -> System.Web.SiteMapNodePublic Overridable Function GetCurrentNodeAndHintAncestorNodes (upLevel As Integer) As SiteMapNodeParametry
- upLevel
- Int32
Liczba generowania węzłów mapy lokacji programu ancestor, które mają być uzyskiwane. Wartość -1 wskazuje, że wszyscy przodkowie mogą być pobierane i buforowane przez dostawcę.
Zwraca
Element SiteMapNode , który reprezentuje aktualnie żądaną stronę; w przeciwnym razie , nulljeśli SiteMapNode element nie zostanie znaleziony lub nie można go zwrócić dla bieżącego użytkownika.
Wyjątki
upLevel wartość jest mniejsza niż -1.
Uwagi
Domyślna implementacja GetCurrentNodeAndHintAncestorNodes metody zwraca CurrentNode właściwość, jednak dostawcy mapy lokacji mogą zastąpić GetCurrentNodeAndHintAncestorNodes metodę i zapewnić zoptymalizowaną implementację, która używa niestandardowych mechanizmów buforowania w celu zwrócenia bieżącego SiteMapNodeelementu , a także węzłów nadrzędnych i węzłów nadrzędnych elementu nadrzędnego.
Parametr upLevel służy do określania liczby poziomów węzłów nadrzędnych i węzłów nadrzędnych do pobrania. Jeśli jest to preferowane, węzły nadrzędne i węzły nadrzędne mogą być połączone z SiteMapNode obiektem zwracanym przez metodę GetCurrentNodeAndHintAncestorNodes ParentNode przy użyciu właściwości .
XmlSiteMapProvider Klasa, która jest domyślnym dostawcą mapy lokacji dla ASP.NET, buforuje całą mapę lokacji w pamięci, co powoduje niewielkie lub niewielkie obciążenie podczas wykonywania zapytań XmlSiteMapProvider dotyczących określonych SiteMapNode obiektów.