XmlSiteMapProvider.FindSiteMapNode(String) 方法

定義

命名空間:

System.Web

組件:

System.Web.dll

擷取 SiteMapNode 物件，其代表位於指定 URL 的頁面。

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

URL，其可識別要擷取 SiteMapNode 的頁面。

傳回

SiteMapNode

SiteMapNode，其代表 rawURL 所識別的頁面。

例外狀況

ProviderException

連結至目前網站地圖提供者的子提供者傳回無效的節點。

備註

XmlSiteMapProvider物件會覆寫 FindSiteMapNode 方法，以確保在基類的執行不會傳回指定之 URL 的節點時，會搜尋節點的任何連結子提供者。

rawUrl參數應該是絕對虛擬路徑或應用程式相對路徑，視在 XML 網站地圖資料檔案中的指定方式而定。

XmlSiteMapProvider衍生自它的類別和類別，會使用物件的 URL SiteMapNode 做為類別所維護之各種集合中的索引鍵。 因此，這些 Url 在網站地圖的範圍內必須是唯一的。 如果在所管理的直屬網站地圖資料內找不到 URL XmlSiteMapProvider ，它會 FindSiteMapNode 透過 provider 其網站地圖節點的屬性，在連結到它的每個子提供者上呼叫。

FindSiteMapNode方法會間接呼叫 BuildSiteMap 方法，以抓取網站地圖中的最上層節點。 因此，在呼叫方法時，也會發生任何針對方法所發生的例外狀況 BuildSiteMap FindSiteMapNode 。

另請參閱

• GetRootNodeCore()
• BuildSiteMap()