XmlSiteMapProvider.FindSiteMapNode(String) 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
检索表示位于指定 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.SiteMapNodePublic Overrides Function FindSiteMapNode (rawUrl As String) As SiteMapNode参数
- rawUrl
- String
标识要为其检索 SiteMapNode 的页的 URL。
返回
一个 SiteMapNode，表示由 rawURL 所标识的页。
例外
链接到当前站点地图提供程序的子提供程序返回一个无效节点。
注解
XmlSiteMapProvider对象重写 FindSiteMapNode 方法，以确保在基类的实现未返回指定 URL 的节点时，为任何链接的子提供程序搜索节点。
rawUrl参数应为绝对虚拟路径或相对于应用程序的路径，具体取决于在 XML 站点地图数据文件中指定的方式。
XmlSiteMapProvider从派生的类和类使用对象的 URL SiteMapNode 作为类维护的各种集合中的键。 因此，这些 Url 在站点地图范围内必须是唯一的。 如果在由管理的直接站点地图数据中找不到该 URL XmlSiteMapProvider ，它将 FindSiteMapNode 通过 provider 其站点地图节点的属性在每个子提供程序上调用。
FindSiteMapNode方法间接调用 BuildSiteMap 方法以检索站点地图中的顶级节点。 因此，当调用方法时，该方法发生的任何异常 BuildSiteMap 也可能发生 FindSiteMapNode 。