StaticSiteMapProvider.AddNode(SiteMapNode, SiteMapNode) 方法

定義

命名空間:

System.Web

組件:

System.Web.dll

將 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。 網站導覽節點的組成網頁必須具有唯一 URL 或索引鍵。

備註

參數所 node 識別的網站地圖節點會新增至內部集合，並在其與參數所 parentNode 識別的網站地圖節點之間建立父子關聯性。

將網站地圖節點新增至內部集合時，可能會解譯網站地圖節點的 URL。 應用程式相對和相對 URL 會展開至應用程式絕對虛擬路徑，然後在內部用來儲存和存取 類別的 SiteMapNode 個別實例。 不會解譯其他 URL，例如實體路徑、具有通訊協定的路徑，以及 UNC 路徑。

XmlSiteMapProvider衍生自 類別的 StaticSiteMapProvider 類別，而且是 ASP.NET 的預設網站地圖提供者，預設會使用 Url 物件的 屬性 SiteMapNode 作為其內部集合中的查閱索引鍵。 如果 的 Url SiteMapNode 屬性已設定，它必須在網站地圖提供者的範圍內是唯一的。 方法 FindSiteMapNode 會嘗試根據其 Url 屬性擷取網站地圖節點。 否則，您可以使用 Key 屬性和對應的 FindSiteMapNodeFromKey 方法來擷取網站地圖節點。 Url如果未指定 或 Key ，網站地圖提供者會自動產生 Key 來追蹤網站地圖節點。

給繼承者的注意事項

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

另請參閱

• RemoveNode(SiteMapNode)