XmlSiteMapProvider.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.
Pobiera obiekt SiteMapNode na podstawie określonego klucza.
public:
override System::Web::SiteMapNode ^ FindSiteMapNodeFromKey(System::String ^ key);public override System.Web.SiteMapNode FindSiteMapNodeFromKey (string key);override this.FindSiteMapNodeFromKey : string -> System.Web.SiteMapNodePublic Overrides Function FindSiteMapNodeFromKey (key As String) As SiteMapNodeParametry
- key
- String
Klucz wyszukiwania, za pomocą którego ma być wyszukiwany element SiteMapNode .
Zwraca
Wartość reprezentująca stronę identyfikowaną przez wartość ; w przeciwnym razie , jeśli jest włączone przycinanie zabezpieczeń i nie można wyświetlać węzła bieżącemu użytkownikowi lub węzeł nie zostanie znaleziony w kolekcji SiteMapNode key null key węzłów.
Wyjątki
Dostawca podrzędny połączony z bieżącym dostawcą mapy lokacji zwrócił nieprawidłowy węzeł.
Uwagi
Klasa zastępuje metodę , aby upewnić się, że każdy połączony dostawca podrzędny jest wyszukiwany w węźle, jeśli implementacja klasy bazowej nie XmlSiteMapProvider zwraca węzła dla klasy FindSiteMapNodeFromKey key .
Obiekt, pochodzący od klasy i domyślnego dostawcy mapy witryny dla usługi ASP.NET, domyślnie używa właściwości obiektu jako klucza odnośnika w kolekcjach XmlSiteMapProvider StaticSiteMapProvider Url SiteMapNode wewnętrznych. Jeśli Url właściwość obiektu SiteMapNode jest ustawiona, musi być unikatowa w zakresie dostawcy. Jeśli nie Url jest określony, XmlSiteMapProvider automatycznie generuje do Key śledzenia węzłów.
Metoda FindSiteMapNodeFromKey może wywołać metodę na wszystkich BuildSiteMap dostawcach podrzędnych skojarzonych z bieżącym dostawcą. W związku z tym wyjątki opisane w BuildSiteMap metodzie mogą być zgłaszane.