XmlSiteMapProvider.FindSiteMapNode(String) Metoda

Definicja

Przestrzeń nazw:

System.Web

Zestaw:

System.Web.dll

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

SiteMapNode

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

Wyjątki

ProviderException

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.

Zobacz też

• GetRootNodeCore()
• BuildSiteMap()