System.Web.XmlSiteMapProvider.FindSiteMapNode Method

Retrieves a System.Web.SiteMapNode object that represents the page at the specified URL.

Syntax

public override SiteMapNode FindSiteMapNode (string rawUrl)

Parameters

rawUrl
A URL that identifies the page for which to retrieve a System.Web.SiteMapNode.

Returns

A System.Web.SiteMapNode that represents the page identified by rawURL.

Remarks

The System.Web.XmlSiteMapProvider object overrides the StaticSiteMapProvider.FindSiteMapNode(string) method to ensure that any linked child providers are searched for the node if the implementation of the base class does not return a node for the specified URL.

The rawUrl parameter should be either an absolute virtual path or an application-relative path, depending on how it is specified in the XML site map data file.

The System.Web.XmlSiteMapProvider class and classes that are derived from it use the URL of a System.Web.SiteMapNode object as a key in the various collections that the class maintains. Therefore, these URLs must be unique within the scope of the site map. If the URL is not found within the immediate site map data that is managed by the System.Web.XmlSiteMapProvider, it calls the XmlSiteMapProvider.FindSiteMapNode(string) on each child provider that is linked to it through the provider attribute of its site map nodes.

The XmlSiteMapProvider.FindSiteMapNode(string) method indirectly calls the XmlSiteMapProvider.BuildSiteMap method to retrieve the top-level node in the site map. Therefore, any exceptions that occur for the XmlSiteMapProvider.BuildSiteMap method can also occur when calling the XmlSiteMapProvider.FindSiteMapNode(string) method.

Requirements

Namespace: System.Web
Assembly: System.Web (in System.Web.dll)
Assembly Versions: 2.0.0.0
Since: .NET 2.0