Udostępnij za pośrednictwem


SiteMapProvider.FindSiteMapNodeFromKey(String) Metoda

Definicja

SiteMapNode Pobiera obiekt na podstawie określonego klucza.

public:
 virtual System::Web::SiteMapNode ^ FindSiteMapNodeFromKey(System::String ^ key);
public virtual System.Web.SiteMapNode FindSiteMapNodeFromKey (string key);
abstract member FindSiteMapNodeFromKey : string -> System.Web.SiteMapNode
override this.FindSiteMapNodeFromKey : string -> System.Web.SiteMapNode
Public Overridable Function FindSiteMapNodeFromKey (key As String) As SiteMapNode

Parametry

key
String

Klucz odnośnika SiteMapNode , za pomocą którego jest tworzony element .

Zwraca

SiteMapNode

Element SiteMapNode reprezentujący stronę zidentyfikowaną przez keyelement ; w przeciwnym razie , nulljeśli nie zostanie znaleziony odpowiedni SiteMapNode lub jeśli nie włączono przycinania zabezpieczeń i SiteMapNode nie można go zwrócić dla bieżącego użytkownika. Wartość domyślna to null.

Uwagi

Implementacja SiteMapProvider jest zwracana null we wszystkich przypadkach. Klasy pochodzące z SiteMapProvider klasy mogą zastąpić FindSiteMapNodeFromKey metodę w celu zapewnienia funkcji wyszukiwania na podstawie unikatowego klucza (zamiast adresu URL, który jest używany przez FindSiteMapNode metodę). Zaimplementuj metodę FindSiteMapNodeFromKey , jeśli implementacja dostawcy mapy lokacji używa SiteMapNode.Key właściwości SiteMapNode obiektu jako identyfikatora podstawowego w strukturze mapy lokacji.

Klasa StaticSiteMapProvider udostępnia implementację, która obsługuje wyszukiwanie węzłów mapy witryny, które nie definiują adresu URL.

XmlSiteMapProvider Klasa, która jest domyślnym dostawcą mapy witryny dla ASP.NET, używa adresu URL SiteMapNode jako klucza w różnych kolekcjach, które klasy utrzymują. W związku z tym jeśli węzeł udostępnia adres URL, musi być unikatowy w zakresie dostawcy mapy witryny. Jeśli nie podano żadnego adresu URL, zostanie wygenerowany unikatowy identyfikator w celu zidentyfikowania elementu SiteMapNode.

Dotyczy

Zobacz też