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; }
/** @property */
public Orientation get_Orientation ()

/** @property */
public void set_Orientation (Orientation value)

public function get Orientation () : Orientation

public function set Orientation (value : Orientation)

Not applicable.

Property Value

One the Orientation enumeration values. The default is Vertical.

Exception typeCondition

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>

Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

Community Additions

ADD
Show:
© 2014 Microsoft