SiteMap.CurrentNode プロパティ

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

SiteMap.CurrentNode プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

現在要求されているページを表す SiteMapNode コントロールを取得します。

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

Visual Basic (宣言)

Public Shared ReadOnly Property
 CurrentNode As SiteMapNode

Visual Basic (使用法)

Dim value As SiteMapNode

value = SiteMap.CurrentNode

C#

public static SiteMapNode CurrentNode { get;
 }

C++

public:
static property SiteMapNode^ CurrentNode {
    SiteMapNode^ get ();
}

J#

/** @property */
public static SiteMapNode get_CurrentNode ()

JScript

public static function get
 CurrentNode () : SiteMapNode

プロパティ値
現在要求されているページを表す SiteMapNode インスタンス。サイト マップ情報に表示するノードがない場合は null 参照 (Visual Basic では Nothing)。

例外

例外の種類	条件
InvalidOperationException	このサイト マップ機能は無効になっています。
ConfigurationErrorsException	構成に指定されている既定のプロバイダが存在しません。
HttpException	この機能は、信頼性が低以上の場合にのみサポートされます。

解説

SiteMap クラスは、CurrentNode プロパティをプロバイダから要求して取得します。

サイト マップ情報にそのページについて表示するノードがない場合、またはセキュリティ トリミングが有効でノードを現在のユーザーに返せない場合、null 参照 (Visual Basic では Nothing) が返されます。

1 つ以上のサブスクリプションが存在する場合、既定のサイト マップ プロバイダによって SiteMapResolve イベントが生成されます。

独自の SiteMapProvider オブジェクトを実装する場合は、CurrentNode を検索および取得する独自の機構を作成します。ただし、StaticSiteMapProvider クラスを拡張し、URL ベースのスキームを使用してページを特定する場合は、FindSiteMapNode メソッドをオーバーライドできます。

使用例

CurrentNode プロパティを使用して現在のページを表す SiteMapNode オブジェクトを取得する方法のコード例を次に示します。

Visual Basic

<Script runat="server">

Private Sub Page_Load(sender As
 Object, e As EventArgs)

    ' Examine the CurrentNode, and navigate the SiteMap relative to
 it.
    Response.Write(SiteMap.CurrentNode.Title & "<BR>")
    Response.Write("<FONT COLOR='red'>" & SiteMap.CurrentNode.Url
 & "</FONT><BR>")

    ' What nodes are children of the CurrentNode?
    If (SiteMap.CurrentNode.HasChildNodes) Then
        Dim ChildNodesEnumerator As IEnumerator
 = SiteMap.CurrentNode.ChildNodes.GetEnumerator()
        While (ChildNodesEnumerator.MoveNext())
            ' Prints the Title of each node.
            Response.Write(ChildNodesEnumerator.Current.ToString() & "<BR>")
        End While
    End If
    Response.Write("<HR>")

    ' Examine the RootNode, and navigate the SiteMap relative to it.
    Response.Write(SiteMap.RootNode.Title & "<BR>")
    Response.Write(SiteMap.RootNode.Url & "<BR>")

    ' What nodes are children of the RootNode?
    If (SiteMap.RootNode.HasChildNodes) Then
        Dim RootNodesChildrenEnumerator As
 IEnumerator = SiteMap.RootNode.ChildNodes.GetEnumerator()
        While (RootNodesChildrenEnumerator.MoveNext())
            ' Prints the Title of each node.
            Response.Write(RootNodesChildrenEnumerator.Current.ToString() & "<BR>")
        End While
    End If

End Sub ' Page_Load
</Script>

C#

<Script runat="server">
private void Page_Load(object sender, System.EventArgs
 e)
{
    // Examine the CurrentNode, and navigate the SiteMap relative to
 it.
    Response.Write(SiteMap.CurrentNode.Title + "<BR>");
    Response.Write("<FONT COLOR='red'>" + SiteMap.CurrentNode.Url
 + "</FONT><BR>");

    // What nodes are children of the CurrentNode?
    if (SiteMap.CurrentNode.HasChildNodes) {
        IEnumerator childNodesEnumerator = SiteMap.CurrentNode.ChildNodes.GetEnumerator();
        while (childNodesEnumerator.MoveNext()) {
            // Prints the Title of each node.
            Response.Write(childNodesEnumerator.Current.ToString() + "<BR>");
        }
    }
    Response.Write("<HR>");

    // Examine the RootNode, and navigate the SiteMap relative to it.
    Response.Write(SiteMap.RootNode.Title + "<BR>");
    Response.Write(SiteMap.RootNode.Url + "<BR>");

    // What nodes are children of the RootNode?
    if (SiteMap.RootNode.HasChildNodes) {
        IEnumerator rootNodesChildrenEnumerator = SiteMap.RootNode.ChildNodes.GetEnumerator();
        while (rootNodesChildrenEnumerator.MoveNext()) {
            // Prints the Title of each node.
            Response.Write(rootNodesChildrenEnumerator.Current.ToString() + "<BR>");
        }
    }
}
</Script>

プラットフォーム

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

参照

関連項目
SiteMap クラス
SiteMap メンバ
System.Web 名前空間
SiteMapProvider.CurrentNode
SiteMapResolve