This documentation is archived and is not being maintained.

Login.CheckBoxStyle Property

Gets a reference to a Style object that defines the settings for the Remember Me check box.

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

[PersistenceModeAttribute(PersistenceMode.InnerProperty)]
public TableItemStyle CheckBoxStyle { get; }

Property Value

Type: System.Web.UI.WebControls.TableItemStyle
A reference to the Style that defines the style settings for the Login control's Remember Me check box.

The CheckBoxStyle property gets a reference to a Style object that you use to change the appearance of the Login control's Remember Me check box.

This property is read-only; however, you can set the properties of the Style object it returns. You can set these properties declaratively in the form Property-Subproperty, where Subproperty represents a property of the Style class (for example, CheckBoxStyle-ForeColor). You can set the property programmatically in the form Property.Subproperty (for example, CheckBoxStyle.ForeColor).

Common settings include custom background color, text color, and font properties. The CheckBoxStyle property defines the appearance of the RememberMeText property.

The style settings for the CheckBoxStyle property are merged with the style settings for the Login control. Any settings made in the CheckBoxStyle property override the corresponding settings in properties of the Login control.

The following Login control style properties are overridden by CheckBoxStyle settings:

When you use templates to define the appearance of the Login control, the CheckBoxStyle property has no effect.

The following code example sets the text color of the Remember Me check box to blue and the font style to italic by setting properties of the Style object referenced by the CheckBoxStyle 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 Page_Load(Object sender, EventArgs e) 
        {
            Login1.CheckBoxStyle.ForeColor = System.Drawing.Color.Blue;
        }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">
            <asp:Login id="Login1" runat="server">
                <CheckBoxStyle Font-Italic="True"></CheckBoxStyle>
            </asp:Login>

        </form>
    </body>
</html>

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

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

.NET Framework

Supported in: 3.5, 3.0, 2.0
Show: