This documentation is archived and is not being maintained.

StaticSiteMapProvider.FindSiteMapNode Method (String)

Note: This method is new in the .NET Framework version 2.0.

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

Namespace: System.Web
Assembly: System.Web (in system.web.dll)

public override SiteMapNode FindSiteMapNode (
	string rawUrl
)
public SiteMapNode FindSiteMapNode (
	String rawUrl
)
public override function FindSiteMapNode (
	rawUrl : String
) : SiteMapNode

Parameters

rawUrl

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

Return Value

A SiteMapNode that represents the page identified by rawURL; otherwise, a null reference (Nothing in Visual Basic), if no corresponding site map node is found.

Exception typeCondition

ArgumentNullException

rawURL is a null reference (Nothing in Visual Basic).

The provided URL is typically a virtual or absolute URL. It can also be a URL that uses ASP.NET application-relative syntax, such as "~/apprelativedirectory". The StaticSiteMapProvider class automatically normalizes application-relative raw URLs to an absolute virtual path.

The XmlSiteMapProvider object, which is derived from the StaticSiteMapProvider and is the default site map provider for ASP.NET, uses the Url property of a SiteMapNode object as a lookup key in its internal collections, by default. If the Url property of the SiteMapNode is set, it must be unique within the scope of the site map provider. The FindSiteMapNode method attempts to retrieve site map nodes based on their Url. Otherwise, you can use the Key property and the corresponding FindSiteMapNodeFromKey method to retrieve site map nodes. If no Url or Key is specified, the site map provider automatically generates a Key property to track the site map nodes.

Notes to Inheritors When overriding the FindSiteMapNode method in a derived class, be sure to normalize the URLs of the SiteMapNode objects that you add to your site map provider, so that the FindSiteMapNode method can retrieve a site map node regardless of whether URL for the site map node is supplied as an absolute virtual path or an application relative path. Security trimming behavior is included in the SiteMapProvider and StaticSiteMapProvider class implementations. However, for security trimming to function in derived classes, you must set the Roles property of any SiteMapNode objects that you create while building a site map provider when you override the BuildSiteMap method.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0
Show: