XmlSiteMapProvider.FindSiteMapNodeFromKey(String) 方法

定义

命名空间:

System.Web

程序集:

System.Web.dll

根据指定的键检索 SiteMapNode 对象。

public:
 override System::Web::SiteMapNode ^ FindSiteMapNodeFromKey(System::String ^ key);

public override System.Web.SiteMapNode FindSiteMapNodeFromKey (string key);

override this.FindSiteMapNodeFromKey : string -> System.Web.SiteMapNode

Public Overrides Function FindSiteMapNodeFromKey (key As String) As SiteMapNode

参数

key

String

用于搜索 SiteMapNode 的查找键。

返回

SiteMapNode

表示 key 所标识的页的 SiteMapNode；如果启用了安全修整并且不能向当前用户显示该节点，或者未能通过 key 在节点集合中找到该节点，则为 null。

例外

ProviderException

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

注解

XmlSiteMapProvider FindSiteMapNodeFromKey 如果基类的实现未返回的节点，则类会重写方法，以确保搜索节点的任何链接子提供程序 key 。

XmlSiteMapProvider默认情况下，从 StaticSiteMapProvider 类和 ASP.NET 的默认站点地图提供程序派生的对象 Url SiteMapNode 在其内部集合中使用对象的属性作为查找键。 如果 Url 设置了的属性 SiteMapNode ，则该属性在提供程序的作用域内必须是唯一的。 如果未 Url 指定，则 XmlSiteMapProvider 会自动生成 Key 以跟踪节点。

此 FindSiteMapNodeFromKey 方法可能会 BuildSiteMap 在与当前提供程序关联的任何子提供程序上调用方法。 因此，可能会引发方法中所述的异常 BuildSiteMap 。

另请参阅

• FindSiteMapNode