共用方式為


XmlSiteMapProvider.FindSiteMapNodeFromKey(String) 方法

定義

根據指定的索引鍵,擷取 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

例外狀況

連結至目前網站地圖提供者的子提供者傳回無效的節點。

備註

XmlSiteMapProvider類別會覆寫 FindSiteMapNodeFromKey 方法,以確保搜尋節點的任何連結子提供者(如果基類的執行不會傳回的節點) key

XmlSiteMapProvider衍生自類別的物件 StaticSiteMapProvider 和 ASP.NET 的預設網站地圖提供者, Url 預設會 SiteMapNode 在其內部集合中使用物件的屬性做為查閱索引鍵。 如果 Url 設定的屬性 SiteMapNode ,則在提供者的範圍內必須是唯一的。 如果未 Url 指定,則 XmlSiteMapProvider 會自動產生 Key 來追蹤節點。

FindSiteMapNodeFromKey方法可能會 BuildSiteMap 在與目前提供者相關聯的任何子提供者上,呼叫方法。 因此,可能會擲回方法中所述的例外狀況 BuildSiteMap

適用於

另請參閱