StaticSiteMapProvider.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。
返回
表示 rawURL 所标识的页的 SiteMapNode；如果没有找到对应的站点地图节点，则为 null。
例外
rawURL 为 null。
注解
提供的 URL 通常是虚拟或绝对 URL。 它也可以是使用 ASP.NET 应用程序相对语法的 URL，例如"~/apprelativedirectory"。 类 StaticSiteMapProvider 自动将应用程序相对原始 URL 规范化到绝对虚拟路径。
默认情况下，该XmlSiteMapProvider对象派生自 StaticSiteMapProvider ASP.NET 的默认站点地图提供程序，使用Url对象的属性SiteMapNode作为其内部集合中的查找键。 如果设置了属性UrlSiteMapNode，则必须在站点地图提供程序的范围内唯一。 该方法 FindSiteMapNode 尝试基于站点映射节点检索站点 Url映射节点。 否则，可以使用 Key 属性和相应的 FindSiteMapNodeFromKey 方法来检索站点映射节点。 Url如果未指定或Key未指定，则站点地图提供程序自动生成用于Key跟踪站点地图节点的属性。
继承者说明
在 FindSiteMapNode(String) 派生类中重写方法时，请确保规范化添加到站点地图提供程序的对象 URL SiteMapNode ，以便 FindSiteMapNode(String) 该方法可以检索站点映射节点，而不管站点映射节点的 URL 是作为绝对虚拟路径还是应用程序相对路径提供。
安全修整行为包含在类StaticSiteMapProvider实现中SiteMapProvider。 但是，若要在派生类中运行安全修整，必须在重写BuildSiteMap()该方法时设置Roles在生成网站地图提供程序时创建的任何SiteMapNode对象的属性。