XmlSiteMapProvider.AddNode(SiteMapNode, SiteMapNode) メソッド


現在のプロバイダーで管理しているコレクションに SiteMapNode オブジェクトを追加します。Adds a SiteMapNode object to the collections that are maintained by the current provider.

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)



プロバイダーに追加する SiteMapNodeThe SiteMapNode to add to the provider.


node の追加先の SiteMapNodeThe SiteMapNode under which to add node.


node または parentNodenull です。node or parentNode is null.

現在の XmlSiteMapProvider が、node に関連付けられたプロバイダーではありません。The current XmlSiteMapProvider is not the provider associated with node.

同じ URL またはキーを持つノードが、既に XmlSiteMapProvider に登録されています。A node with the same URL or key is already registered with the XmlSiteMapProvider. または- or - 重複したサイト マップ ノードが、2 つのサイト マップ プロバイダーのリンク時などに、プログラムによって検出されました。A duplicate site map node has been encountered programmatically, such as when linking two site map providers.

または-or- nodeXmlSiteMapProvider のルート ノードです。node is the root node of the XmlSiteMapProvider.


nodeパラメーターが内部コレクションに追加され、との間に親子関係が作成され parentNode ます。The node parameter is added to an internal collection, and a parent/child relationship is created between it and parentNode.

クラス XmlSiteMapProvider から派生 StaticSiteMapProvider し、ASP.NET の既定のサイトマッププロバイダーであるクラスは、 Url 既定で、オブジェクトのプロパティを SiteMapNode 内部コレクション内の参照キーとして使用します。The XmlSiteMapProvider class, derived from the StaticSiteMapProvider class and the default site map provider for ASP.NET, uses the Url property of a SiteMapNode object as a lookup key in its internal collections, by default. Urlのプロパティが設定されている場合は、 SiteMapNode プロバイダーのスコープ内で一意である必要があります。If the Url property of the SiteMapNode is set, it must be unique within the scope of the provider. メソッドは、 FindSiteMapNode に基づいてノードを取得しようとし Url ます。The FindSiteMapNode method attempts to retrieve nodes based on their Url. それ以外の場合は、 Key プロパティと、対応する FindSiteMapNodeFromKey メソッドを使用してノードを取得できます。Otherwise, you can use the Key property, and the corresponding FindSiteMapNodeFromKey method, to retrieve nodes.