XmlSiteMapProvider.FindSiteMapNode(String) 方法

定义

命名空间:

System.Web

程序集:

System.Web.dll

检索表示位于指定 URL 处的页的 SiteMapNode 对象。

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

参数

rawUrl

String

标识要为其检索 SiteMapNode 的页的 URL。

返回

SiteMapNode

一个 SiteMapNode，表示由 rawURL 所标识的页。

例外

ProviderException

链接到当前站点地图提供程序的子提供程序返回一个无效节点。

注解

XmlSiteMapProvider对象重写 FindSiteMapNode 方法，以确保在基类的实现未返回指定 URL 的节点时，为任何链接的子提供程序搜索节点。

rawUrl参数应为绝对虚拟路径或相对于应用程序的路径，具体取决于在 XML 站点地图数据文件中指定的方式。

XmlSiteMapProvider从派生的类和类使用对象的 URL SiteMapNode 作为类维护的各种集合中的键。 因此，这些 Url 在站点地图范围内必须是唯一的。 如果在由管理的直接站点地图数据中找不到该 URL XmlSiteMapProvider ，它将 FindSiteMapNode 通过 provider 其站点地图节点的属性在每个子提供程序上调用。

FindSiteMapNode方法间接调用 BuildSiteMap 方法以检索站点地图中的顶级节点。 因此，当调用方法时，该方法发生的任何异常 BuildSiteMap 也可能发生 FindSiteMapNode 。

另请参阅

• GetRootNodeCore()
• BuildSiteMap()