Export (0) Print
Expand All

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.5, 4, 3.5, 3.0, 2.0

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

Show:
© 2014 Microsoft