SiteMapPath.CreateControlHierarchy メソッド

.NET Framework クラス ライブラリ リファレンス

SiteMapPath.CreateControlHierarchy メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

SiteMapProvider によって提供されるサイト マップ構造を調べ、機能ノードに定義されたスタイルとテンプレートに基づいて子コントロールのコレクションを構築します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Protected Overridable Sub
 CreateControlHierarchy

Visual Basic (使用法)

Me.CreateControlHierarchy

C#

protected virtual void CreateControlHierarchy
 ()

C++

protected:
virtual void CreateControlHierarchy ()

J#

protected void CreateControlHierarchy ()

JScript

protected function CreateControlHierarchy ()

例外

例外の種類	条件
HttpException	SiteMapPath コントロールに使用できる SiteMapProvider がありません。

解説

CreateControlHierarchy メソッドは、SiteMapNodeItem コントロールを作成し、現在のサイト マップ プロバイダの対応する SiteMapNode オブジェクトに関連付け、ノードを Controls コレクションに追加します。

このメソッドは、最初に SiteMap.CurrentNode を検索し、次に SiteMapNode オブジェクトの階層ツリーを上に移動しながら、RootNode に到達するまでそれぞれの SiteMapNodeItem を作成します。それぞれの SiteMapNodeItem を作成した後、対応する SiteMapNode に関連付ける前に InitializeItem メソッドが呼び出されます。InitializeItem メソッドは、特定のノード型に対して定義されたテンプレートまたはスタイルを適用し、SiteMapNodeItem に含まれる子コントロールを作成および初期化します。最後に、InitializeItem メソッドが SiteMapNodeItem の子コントロールを Controls コレクションに追加します。

それぞれの SiteMapNodeItem が初期化された後、OnItemCreated メソッドが呼び出されます。その後、SiteMapNodeItem が対応する SiteMapNode に関連付けられ、OnDataBound が呼び出されます。

CreateControlHierarchy メソッドは、CreateChildControls メソッドから呼び出されます。

SiteMapPath コントロールを拡張するクラスでは、CreateControlHierarchy メソッドをオーバーライドして、SiteMapNodeItem コントロールを作成する方法や SiteMapPath コントロールに追加する方法を変更します。個々のノード項目の操作は InitializeItem メソッドで実行され、SiteMapPath を拡張するほとんどのクラスは、そのメソッドだけをオーバーライドします。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
SiteMapPath クラス
SiteMapPath メンバ
System.Web.UI.WebControls 名前空間
CreateChildControls
InitializeItem
その他の技術情報
ASP.NET サイト ナビゲーション
SiteMapPath Web サーバー コントロールの概要