Login.Orientation Property

Reference

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

public:
 virtual property System::Web::UI::WebControls::Orientation Orientation { System::Web::UI::WebControls::Orientation get(); void set(System::Web::UI::WebControls::Orientation value); };

public virtual System.Web.UI.WebControls.Orientation Orientation { get; set; }

member this.Orientation : System.Web.UI.WebControls.Orientation with get, set

Public Overridable Property Orientation As Orientation

Property Value

Orientation

One the Orientation enumeration values. The default is Vertical.

Exceptions

ArgumentOutOfRangeException

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

Examples

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>

<%@ 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>

Remarks

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.

Applies to