SiteMapProvider.FindSiteMapNodeFromKey(String) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
根據指定的索引鍵,擷取 SiteMapNode 物件。
public:
virtual System::Web::SiteMapNode ^ FindSiteMapNodeFromKey(System::String ^ key);
public virtual System.Web.SiteMapNode FindSiteMapNodeFromKey (string key);
abstract member FindSiteMapNodeFromKey : string -> System.Web.SiteMapNode
override this.FindSiteMapNodeFromKey : string -> System.Web.SiteMapNode
Public Overridable Function FindSiteMapNodeFromKey (key As String) As SiteMapNode
參數
- key
- String
查閱索引鍵,用來建立 SiteMapNode。
傳回
表示 key
所識別之網頁的 SiteMapNode,但如果找不到對應的 SiteMapNode,或安全性調整已啟用,而無法傳回目前使用者的 SiteMapNode,則為 null
。 預設為 null
。
備註
實 SiteMapProvider 作在所有情況下都會 null
傳回。 衍生自 類別的 SiteMapProvider 類別可以覆寫 FindSiteMapNodeFromKey 方法,根據唯一索引鍵 (提供查閱功能,而不是方法) 所使用的 FindSiteMapNode URL。 FindSiteMapNodeFromKey如果您的網站地圖提供者實作使用 SiteMapNode.Key 物件的 屬性 SiteMapNode 做為網站地圖結構中的主要識別碼,請實作 方法。
類別 StaticSiteMapProvider 提供實作,可處理搜尋未定義 URL 的網站地圖節點。
類別 XmlSiteMapProvider 是 ASP.NET 的預設網站地圖提供者,會使用 的 SiteMapNode URL 做為類別所維護之各種集合中的索引鍵。 因此,如果節點提供 URL,它必須在網站地圖提供者的範圍內是唯一的。 如果未提供 URL,則會產生唯一識別碼來識別 SiteMapNode 。