Udostępnij za pośrednictwem


XmlSiteMapProvider.FindSiteMapNode(String) Metoda

Definicja

SiteMapNode Pobiera obiekt reprezentujący stronę pod określonym adresem URL.

public:
 override System::Web::SiteMapNode ^ FindSiteMapNode(System::String ^ rawUrl);
public override System.Web.SiteMapNode FindSiteMapNode (string rawUrl);
override this.FindSiteMapNode : string -> System.Web.SiteMapNode
Public Overrides Function FindSiteMapNode (rawUrl As String) As SiteMapNode

Parametry

rawUrl
String

Adres URL identyfikujący stronę, dla której ma być pobierany SiteMapNodeelement .

Zwraca

Element SiteMapNode reprezentujący stronę zidentyfikowaną przez rawURLelement .

Wyjątki

Dostawca podrzędny połączony z bieżącym dostawcą mapy lokacji zwrócił węzeł, który jest nieprawidłowy.

Uwagi

Obiekt XmlSiteMapProvider zastępuje metodę FindSiteMapNode , aby upewnić się, że wszyscy połączoni dostawcy podrzędni są wyszukiwani dla węzła, jeśli implementacja klasy bazowej nie zwraca węzła dla określonego adresu URL.

Parametr rawUrl powinien być bezwzględną ścieżką wirtualną lub ścieżką względną aplikacji, w zależności od tego, jak jest określony w pliku danych mapy witryny XML.

Klasa XmlSiteMapProvider i klasy, które pochodzą z niej, używają adresu URL SiteMapNode obiektu jako klucza w różnych kolekcjach, które utrzymuje klasa. W związku z tym te adresy URL muszą być unikatowe w zakresie mapy witryny. Jeśli adres URL nie zostanie znaleziony w danych mapy lokacji natychmiastowej zarządzanej przez usługę XmlSiteMapProvider, wywołuje FindSiteMapNode on każdego dostawcę podrzędnego połączonego z nim za pomocą provider atrybutu węzłów mapy witryny.

Metoda FindSiteMapNode pośrednio wywołuje metodę BuildSiteMap w celu pobrania węzła najwyższego poziomu na mapie lokacji. W związku z tym wszelkie wyjątki występujące dla BuildSiteMap metody mogą również wystąpić podczas wywoływania FindSiteMapNode metody.

Dotyczy

Zobacz też