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 作為其內部集合中的查閱索引鍵。 如果 設定 的 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