PasswordRecovery.InstructionTextStyle Property

 

Gets a reference to a collection of style properties that define the appearance of explanatory text in the PasswordRecovery control.

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

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

Property Value

Type: System.Web.UI.WebControls.TableItemStyle

A reference to a TableItemStyle that contains properties that define the appearance of explanatory text.

The InstructionTextStyle property defines the appearance of explanatory text in the PasswordRecovery control. This property is read-only; however, you can set the properties of the Style object it returns. You can set the properties declaratively in the form Property-Subproperty, where Subproperty represents a property of the Style class (for example, InstructionTextStyle-ForeColor). You can also set the properties 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 following properties:

Style settings made to the InstructionTextStyle property are merged with the style settings for the PasswordRecovery control. Any settings made in the InstructionTextStyle property override the corresponding settings in properties of the PasswordRecovery control.

The following PasswordRecovery control properties are overridden by InstructionTextStyle properties:

When you use templates to define the appearance of the PasswordRecovery control's UserName view or Question view, the InstructionTextStyle property has no effect.

The following code example shows how to set the InstructionTextStyle property.

<%@ page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void PasswordRecovery1_UserLookupError(object sender, EventArgs e)
  {
    PasswordRecovery1.UserNameInstructionText = "Enter the correct Web site user name.";
    PasswordRecovery1.InstructionTextStyle.ForeColor = System.Drawing.Color.Red;
  }

  void PasswordRecovery1_AnswerLookupError(object sender, EventArgs e)
  {
    PasswordRecovery1.QuestionInstructionText = "Enter the correct answer to this question.";
    PasswordRecovery1.InstructionTextStyle.ForeColor = System.Drawing.Color.Red;
  }

</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:passwordrecovery id="PasswordRecovery1" runat="server" 
    questioninstructiontext="Enter the answer to the password confirmation question."
    usernameinstructiontext="Enter your Web site user name." 
    OnUserLookupError="PasswordRecovery1_UserLookupError" OnAnswerLookupError="PasswordRecovery1_AnswerLookupError">
    <instructiontextstyle 
      font-size="Smaller" 
      font-names="Comic Sans MS" 
      font-italic="True" 
      forecolor="Blue">
    </instructiontextstyle>
  </asp:passwordrecovery>
</form>
</body>
</html>

.NET Framework
Available since 2.0
Return to top
Show: