StaticSiteMapProvider.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。

注解

方法FindSiteMapNodeFromKey基于 key从内部Hashtable对象中检索站点地图节点。

对象 XmlSiteMapProvider 派生自 StaticSiteMapProvider 类，是 ASP.NET 的默认站点地图提供程序，默认情况下，使用 Url 对象的 属性 SiteMapNode 作为其内部集合中的查找键。 Url如果设置了 的 SiteMapNode 属性，则它在站点地图提供程序的范围内必须是唯一的。 方法 FindSiteMapNode 尝试根据其 Url检索站点地图节点。 否则，可以使用 Key 属性和相应的 FindSiteMapNodeFromKey 方法来检索站点地图节点。

StaticSiteMapProvider具有一个默认实现，该实现基于 key 参数查找 类的SiteMapNode实例。 如果站点地图提供程序实现者使用 AddNode 方法， StaticSiteMapProvider 则 已根据 属性的值存储了对每个 SiteMapNode 的 SiteMapNode.Key 引用。 默认情况下， XmlSiteMapProvider 为没有 属性值的SiteMapNode.Url类实例SiteMapNode生成 GUID。 自定义站点地图提供程序实现者必须提供自己的机制，以便在类的SiteMapNode.KeySiteMapNode实例没有属性的值时生成属性的唯一值SiteMapNode.Url。

SiteMapProvider和 XmlSiteMapProvider 类是 ASP.NET 的默认站点地图提供程序实现，它们使用 对象的 URL SiteMapNode 作为这些类维护的各种集合中的键。

另请参阅

• FindSiteMapNode