語言

StaticSiteMapProvider.AddNode(SiteMapNode, SiteMapNode) 方法

定義

命名空間:
System.Web
組件:
System.Web.dll

將 a SiteMapNode 加入由網站地圖提供者維護的集合，並在物件間 SiteMapNode 建立父子關係。

protected public:
 override void AddNode(System::Web::SiteMapNode ^ node, System::Web::SiteMapNode ^ parentNode);
protected internal override void AddNode(System.Web.SiteMapNode node, System.Web.SiteMapNode parentNode);
override this.AddNode : System.Web.SiteMapNode * System.Web.SiteMapNode -> unit
Protected Friend Overrides Sub AddNode (node As SiteMapNode, parentNode As SiteMapNode)

參數

node
SiteMapNode

SiteMapNode要補充給網站地圖供應商。

parentNode
SiteMapNode

SiteMapNode在 下層加入 node。

例外狀況

ArgumentNullException

node 是 null。

InvalidOperationException

該 Url 或 Key 已在 StaticSiteMapProvider. 網站地圖節點必須由具有獨特網址或鍵的頁面組成。

備註

由 node 參數識別的站點地圖節點會加入內部集合，並在該集合與由 parentNode 參數識別的站點地圖節點之間建立父子關係。

當網站地圖節點加入內部集合時，可能會解讀該節點的網址。 應用程式相對與相對 URL 擴展為應用程式絕對虛擬路徑，這些路徑在內部用於儲存和存取類別 SiteMapNode 的個別實例。 其他 URL，如實體路徑、包含協定的路徑，以及 UNC 路徑，則不會被解讀。

這個 XmlSiteMapProvider 類別是從該 StaticSiteMapProvider 類別衍生出來，並且是 ASP.NET 的預設網站地圖提供者，預設會將 Url 物件的屬性 SiteMapNode 作為其內部集合中的查詢鍵。 若 Url 的屬性 SiteMapNode 被設定，則必須在網站地圖提供者的範圍內是唯一。 此 FindSiteMapNode 方法嘗試根據節點 Url 的性質擷取節點。 否則，你可以利用該 Key 屬性及其對應 FindSiteMapNodeFromKey 方法來取得網站地圖節點。 若指定 或 UrlKey ，網站地圖提供者會自動產生 以 Key 追蹤網站地圖節點。

給繼承者的注意事項

覆寫該 AddNode(SiteMapNode, SiteMapNode) 方法時，請確保 Key 在使用該 AddNode 方法新增網站地圖節點時，該屬性設定為唯一值。

適用於

另請參閱