SiteMapProvider.FindSiteMapNodeFromKey(String) 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.
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.SiteMapNodePublic Overridable Function FindSiteMapNodeFromKey (key As String) As SiteMapNodeParametry
- key
- String
Klucz odnośnika SiteMapNode , za pomocą którego jest tworzony element .
Zwraca
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.