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)

'Declaration
Public Overridable Property Orientation As Orientation
'Usage
Dim instance As Login
Dim value As Orientation

value = instance.Orientation

instance.Orientation = value
/** @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="VB" 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">
Sub changeOrientation_Click(ByVal sender As Object, ByVal e As EventArgs)
    If Login1.Orientation = Orientation.Horizontal Then
        Login1.Orientation = Orientation.Vertical
    Else
        Login1.Orientation = Orientation.Horizontal
    End If
End Sub

</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: