This documentation is archived and is not being maintained.

SiteMapPath.PathDirection Property

Gets or sets the order that the navigation path nodes are rendered in.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

public virtual PathDirection PathDirection { get; set; }
<asp:SiteMapPath PathDirection="PathDirection" />

Property Value

Type: System.Web.UI.WebControls.PathDirection
A PathDirection that indicates the hierarchical order that navigation nodes are rendered in. The default is RootToCurrent, which indicates that the nodes are rendered in hierarchical order from the top-most node to the current node, from left to right.

ExceptionCondition
ArgumentOutOfRangeException

The value for PathDirection is not one of the base PathDirection enumerations.

Set PathDirection to RootToCurrent if you want to display the navigation path from left to right; the navigation path appears as a progression from left to right of site map nodes. In other words, the root node is at the leftmost position, each subsequent node is in the next position to the right, and the current node is in the rightmost position.

Set PathDirection to CurrentToRoot if you want to display the navigation path from right to left. In other words, the node order is reversed so that the root node displays at the rightmost position and the current node displays at the leftmost position. While not as common, this ordering can be used for localizing Web Forms pages and the SiteMapPath control for languages that read from right to left.

The value of this property is stored in view state.

The following code example demonstrates how to declaratively set the PathDirection property of a SiteMapPath in a Web Forms page.


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

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head>
        <title>Catalog</title>
    </head>
    <body>
        <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"
                    RenderCurrentNodeAsLink="false"
                    ShowToolTips="false"/></p>
        </form>
    </body>
</html>


.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: