Export (0) Print
Expand All

Login.Orientation Property

Gets or sets a value that specifies the position of the elements of the Login control on the page.

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

public virtual Orientation Orientation { get; set; }
<asp:Login Orientation="Orientation" />

Property Value

Type: System.Web.UI.WebControls.Orientation
One the Orientation enumeration values. The default is Vertical.

ExceptionCondition
ArgumentOutOfRangeException

The Orientation property is not set to a valid Orientation enumeration value.

The Orientation property determines whether to display the Login control in a vertical format, with the UserName text entry field above the Password text entry field, or in a horizontal format, with the UserName text entry field next to the Password text entry field.

The following code example shows the effect of changing the Orientation property.

<%@ Page Language="C#" AutoEventWireup="False"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
    void changeOrientation_Click(object sender, EventArgs e) 
    {
        if (Login1.Orientation == Orientation.Vertical)
            Login1.Orientation = Orientation.Horizontal;
        else
            Login1.Orientation = Orientation.Vertical;
    }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">
            <table style="text-align:center; border-width:1">
                <tr>
                    <td>
                        <asp:Login id="Login1" runat="server" Orientation="Vertical" CreateUserText="Create a new user..."
                            CreateUserUrl="newUser.aspx" HelpPageText="Help logging in..." HelpPageUrl="help.aspx"
                            PasswordRecoveryText="Recover your password..." PasswordRecoveryUrl="getPass.aspx"></asp:Login>
                    </td>
                </tr>
                <tr>
                    <td align="center">
                        <asp:Button id="changeOrientation" Text="Change Orientration" runat="Server" OnClick="changeOrientation_Click"></asp:Button>
                    </td>
                </tr>
            </table>
        </form>
    </body>
</html>

.NET Framework

Supported in: 4.6, 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