XmlSiteMapProvider.FindSiteMapNode(String) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得 SiteMapNode 代表指定網址頁面的物件。
public:
override System::Web::SiteMapNode ^ FindSiteMapNode(System::String ^ rawUrl);
public override System.Web.SiteMapNode FindSiteMapNode(string rawUrl);
override this.FindSiteMapNode : string -> System.Web.SiteMapNode
Public Overrides Function FindSiteMapNode (rawUrl As String) As SiteMapNode
參數
- rawUrl
- String
一個用來識別要取 SiteMapNode回 .
傳回
SiteMapNode A 代表由 所rawURL識別的頁面。
例外狀況
一個連結到目前網站地圖提供者的子提供者回傳了一個無效的節點。
備註
XmlSiteMapProvider物件會覆寫該FindSiteMapNode方法,確保如果基底類別實作未回傳指定 URL 的節點,任何連結的子提供者都會被搜尋。
rawUrl參數應為絕對虛擬路徑或應用相對路徑,視 XML 站點地圖資料檔中的指定而定。
XmlSiteMapProvider從該類別衍生的類別會將物件的SiteMapNode網址作為該類別維護的各種集合中的鍵。 因此,這些網址必須在網站地圖範圍內是唯一的。 如果 在由 管理 XmlSiteMapProvider的即時網站地圖資料中找不到該 URL,則會呼叫 FindSiteMapNode 每個透過 provider 其網站地圖節點屬性連結到它的子提供者。
該 FindSiteMapNode 方法間接呼叫 BuildSiteMap 該方法來取得站點地圖中的頂層節點。 因此,該方法遇到 BuildSiteMap 的任何例外也可能在呼叫 FindSiteMapNode 該方法時發生。