XmlSiteMapProvider.FindSiteMapNode(String) 方法

定义

检索一个 SiteMapNode 对象,该对象表示指定 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

参数

rawUrl
String

一个 URL,用于标识要为其检索的 SiteMapNode页。

返回

一个 SiteMapNode 表示由 rawURL该页标识的页面。

例外

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

注解

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

参数 rawUrl 应该是绝对虚拟路径或应用程序相对路径,具体取决于它在 XML 站点映射数据文件中指定的方式。

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

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

适用于

另请参阅