SiteMapPath.PathDirection プロパティとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

SiteMapPath.PathDirection プロパティ

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

ナビゲーションパスの各ノードが表示される順序を取得または設定します。

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

Visual Basic (宣言)

Public Overridable Property
 PathDirection As PathDirection

Visual Basic (使用法)

Dim instance As SiteMapPath
Dim value As PathDirection

value = instance.PathDirection

instance.PathDirection = value

public virtual PathDirection PathDirection { get;
 set; }

C++

public:
virtual property PathDirection PathDirection {
    PathDirection get ();
    void set (PathDirection value);
}

/** @property */
public PathDirection get_PathDirection ()

/** @property */
public void set_PathDirection (PathDirection
 value)

JScript

public function get PathDirection
 () : PathDirection

public function set PathDirection
 (value : PathDirection)

プロパティ値
ナビゲーションノードが表示される階層の順序を示す PathDirection。既定値は RootToCurrent です。これは、各ノードが一番上のノードから現在のノードへの階層順序で、左から右に表示されることを示します。

例外

例外の種類	条件
ArgumentOutOfRangeException	PathDirection の値が、基本 PathDirection 列挙値の 1 つではありません。

解説

ナビゲーションパスを左から右に表示する場合は、PathDirection を RootToCurrent に設定します。ナビゲーションパスは、サイトマップの各ノードを左から右に進む形で表示されます。つまり、ルートノードが左端、それに続く各ノードはその右隣の位置、そして現在のノードが右端の位置に表示されます。

ナビゲーションパスを右から左に表示する場合は、PathDirection を CurrentToRoot に設定します。つまり、ルートノードが右端の位置、現在のノードが左端の位置に表示されるようにノードの順序が反転します。この順序は一般的ではありませんが、Web フォームのページと SiteMapPath コントロールを右から左に読む言語にローカライズするときに使用できます。

このプロパティの値はビューステートに格納されます。

Topic	Location
方法 : SiteMapPath Web サーバーコントロールの外観をカスタマイズする	ASP .NET Web アプリケーションの作成

使用例

Web フォームページで SiteMapPath の PathDirection プロパティを宣言によって設定する方法を次のコード例に示します。

Visual Basic

<%@ Page language="VB"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML
 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<HTML>
    <HEAD>
        <title>Catalog</title>
    </HEAD>
    <body MS_POSITIONING="FlowLayout">
        <form id="Form1" method="post"
 runat="server">
            <p><asp:SiteMapPath runat="server"
 ID="SiteMapPath1"
                    RootNodeStyle-Font-Bold="true"
                    RootNodeStyle-Font-Names="Arial Black"
                    RootNodeStyle-Font-Italic="True"
                    RootNodeStyle-ForeColor="Green"
                    CurrentNodeStyle-ForeColor="Orange"
                    PathSeparator="<::>"
                    PathDirection="CurrentToRoot"
                    CurrentNodeAsLink="false"
                    ShowToolTips="false"/></p>
        </form>
    </body>
</HTML>

<%@ Page language="c#"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<HTML>
    <HEAD>
        <title>Catalog</title>
    </HEAD>
    <body MS_POSITIONING="FlowLayout">
        <form id="Form1" method="post" runat="server">
            <p><asp:SiteMapPath runat="server" ID="SiteMapPath1"
                    RootNodeStyle-Font-Bold="true"
                    RootNodeStyle-Font-Names="Arial Black"
                    RootNodeStyle-Font-Italic="True"
                    RootNodeStyle-ForeColor="Green"
                    CurrentNodeStyle-ForeColor="Orange"
                    PathSeparator="<::>"
                    PathDirection="CurrentToRoot"
                    CurrentNodeAsLink="false"
                    ShowToolTips="false"/></p>
        </form>
    </body>
</HTML>

<%@ Page Language="VJ#"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<HTML>
    <HEAD>
        <title>Catalog</title>
    </HEAD>
    <body MS_POSITIONING="FlowLayout">
        <form id="Form1" method="post" runat="server">
            <p><asp:SiteMapPath runat="server" ID="SiteMapPath1"
                    RootNodeStyle-Font-Bold="true"
                    RootNodeStyle-Font-Names="Arial Black"
                    RootNodeStyle-Font-Italic="True"
                    RootNodeStyle-ForeColor="Green"
                    CurrentNodeStyle-ForeColor="Orange"
                    PathSeparator="<::>"
                    PathDirection="CurrentToRoot"
                    CurrentNodeAsLink="false"
                    ShowToolTips="false"/></p>
        </form>
    </body>
</HTML>