Login.InstructionTextStyle 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 a reference to a TableItemStyle object that defines the settings for instruction text in the Login control.

public:
 property System::Web::UI::WebControls::TableItemStyle ^ InstructionTextStyle { System::Web::UI::WebControls::TableItemStyle ^ get(); };

[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public System.Web.UI.WebControls.TableItemStyle InstructionTextStyle { get; }

[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.InstructionTextStyle : System.Web.UI.WebControls.TableItemStyle

Public ReadOnly Property InstructionTextStyle As TableItemStyle

Property Value

TableItemStyle

A reference to the TableItemStyle that contains the style settings of the Login control instruction text.

Attributes: PersistenceModeAttribute

Examples

The following code example sets the instruction text and the background color for the instruction text by setting properties of the TableItemStyle object referenced by the InstructionTextStyle 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">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <asp:Login id="Login1" runat="server" 
            InstructionText="Enter your user name and password to log in.">
        <InstructionTextStyle Font-Bold="True" ForeColor="#E0E0E0" BackColor="Gray"></InstructionTextStyle>
        </asp:Login>
    </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">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <asp:Login id="Login1" runat="server" 
            InstructionText="Enter your user name and password to log in.">
        <InstructionTextStyle Font-Bold="True" ForeColor="#E0E0E0" BackColor="Gray"></InstructionTextStyle>
        </asp:Login>
    </form>
</body>
</html>

Remarks

The InstructionTextStyle property defines the appearance of instruction text in the Login control. This property is read-only; however, you can set the properties of the TableItemStyle object it returns. You can set these properties declaratively in the form Property-Subproperty, where Subproperty represents a property of the TableItemStyle class (for example, InstructionTextStyle-ForeColor). You can set the property programmatically in the form Property.Subproperty (for example, InstructionTextStyle.ForeColor).

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

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

The following Login style properties are overridden by InstructionTextStyle settings:

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

Applies to

Jaa