Udostępnij za pośrednictwem


SiteMapProvider.GetCurrentNodeAndHintAncestorNodes(Int32) Metoda

Definicja

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.SiteMapNode
Public Overridable Function GetCurrentNodeAndHintAncestorNodes (upLevel As Integer) As SiteMapNode

Parametry

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

SiteMapNode

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.

Dotyczy

Zobacz też