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