Udostępnij za pośrednictwem


XmlSiteMapProvider.FindSiteMapNodeFromKey(String) Metoda

Definicja

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.SiteMapNode
Public Overrides Function FindSiteMapNodeFromKey (key As String) As SiteMapNode

Parametry

key
String

Klucz wyszukiwania, za pomocą którego ma być wyszukiwany element SiteMapNode .

Zwraca

SiteMapNode

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.

Dotyczy

Zobacz też