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

node の追加先の SiteMapNode。

例外

ArgumentNullException

node が nullです。

InvalidOperationException

Url または Key が既に StaticSiteMapProvider に登録されています。 サイト マップ ノードは、一意の URL またはキーを使用したページで構成されている必要があります。

注釈

パラメーターによって node 識別されるサイト マップ ノードが内部コレクションに追加され、 パラメーターで parentNode 識別されるサイト マップ ノードとの間に親子リレーションシップが作成されます。

サイト マップ ノードの URL は、内部コレクションに追加されるときに解釈される場合があります。 アプリケーション相対 URL と相対 URL は、アプリケーション絶対仮想パスに拡張され、クラスの個々の SiteMapNode インスタンスを格納およびアクセスするために内部的に使用されます。 物理パス、プロトコルが含まれるパス、UNC パスなど、その他の URL は解釈されません。

クラスからStaticSiteMapProvider派生し、ASP.NET の既定のサイト マップ プロバイダーである クラスはXmlSiteMapProvider、オブジェクトの SiteMapNode プロパティを内部コレクションの参照キーとして既定で使用Urlします。 の SiteMapNode プロパティがUrl設定されている場合は、サイト マップ プロバイダーのスコープ内で一意である必要があります。 メソッドは FindSiteMapNode 、プロパティに基づいてサイト マップ ノードの取得を Url 試みます。 それ以外の場合は、 プロパティと対応するFindSiteMapNodeFromKeyメソッドを使用Keyしてサイト マップ ノードを取得できます。 または Key が指定されていないUrl場合、サイト マップ プロバイダーはサイト マップ ノードをKey追跡するために を自動的に生成します。

注意 (継承者)

メソッドをオーバーライドするときは、 メソッドをAddNode(SiteMapNode, SiteMapNode)Key使用してサイト マップ ノードを追加するときに、 プロパティが一意の値にAddNode設定されていることを確認します。

こちらもご覧ください

• RemoveNode(SiteMapNode)