StaticSiteMapProvider.FindSiteMapNodeFromKey(String) 方法

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 所識別之網頁的 SiteMapNode，如果安全性調整已啟用並且網站導覽節點無法對目前使用者顯示，或無法使用 key 在網站導覽節點集合中找到該網站導覽節點，則為 null。

備註

方法會 FindSiteMapNodeFromKey 根據 key 從內部 Hashtable 物件擷取網站地圖節點。

衍生 XmlSiteMapProvider 自 StaticSiteMapProvider 類別的 物件，而且是 ASP.NET 的預設網站地圖提供者，預設會使用 Url 物件的 屬性 SiteMapNode 作為其內部集合中的查閱索引鍵。 如果 設定 的 UrlSiteMapNode 屬性，它必須在網站地圖提供者的範圍內是唯一的。 方法 FindSiteMapNode 會嘗試根據其 Url 來擷取網站地圖節點。 否則，您可以使用 Key 屬性和對應的 FindSiteMapNodeFromKey 方法來擷取網站地圖節點。

StaticSiteMapProvider具有預設實作，它會根據 key 參數來查閱 類別的 SiteMapNode 實例。 如果網站地圖提供者實作者使用 AddNode 方法，則 StaticSiteMapProvider 已經根據 屬性的值儲存每個 SiteMapNode 的 SiteMapNode.Key 參考。 根據預設，會產生 XmlSiteMapProvider 類別實例的 SiteMapNode GUID，這些實例沒有 屬性的值 SiteMapNode.Url 。 自訂網站地圖提供者實作者必須提供自己的機制，以在 類別的 SiteMapNode 實例沒有 屬性的值時產生屬性的唯一值。 SiteMapNode.KeySiteMapNode.Url

SiteMapProvider和 XmlSiteMapProvider 類別是 ASP.NET 的預設網站地圖提供者實作，請使用 物件 URL SiteMapNode 做為類別所維護之各種集合中的索引鍵。

適用於

另請參閱

• FindSiteMapNode