PasswordRecovery.HyperLinkStyle 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 collection of properties that define the appearance of hyperlinks on the PasswordRecovery control.

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

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

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

Public ReadOnly Property HyperLinkStyle As TableItemStyle

Property Value

TableItemStyle

A reference to the TableItemStyle that contains the settings that define the appearance of hyperlinks.

Attributes: PersistenceModeAttribute

Examples

The following code example uses the HyperLinkStyle property to highlight the Help page link when a user enters a user name that is not found in the data store in the PasswordRecovery control.

<%@ 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.HelpPageText = "Need help with recovering your password?";
        PasswordRecovery1.HyperLinkStyle.BackColor = System.Drawing.Color.DarkGreen;
        PasswordRecovery1.HyperLinkStyle.ForeColor = System.Drawing.Color.White;
    }
    
</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"
      helppagetext="Help with recovering your password" 
      helppageurl="recoveryHelp.aspx" OnUserLookupError="PasswordRecovery1_UserLookupError">
        <hyperlinkstyle backcolor="#E0E0E0"></hyperlinkstyle>
    </asp:passwordrecovery>

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

<%@ page language="VB" %>

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

    
    Sub PasswordRecovery1_UserLookupError(ByVal sender As Object, ByVal e As System.EventArgs)
        PasswordRecovery1.HelpPageText = "Need help with recovering your password?"
        PasswordRecovery1.HyperLinkStyle.BackColor = System.Drawing.Color.DarkGreen
        PasswordRecovery1.HyperLinkStyle.ForeColor = System.Drawing.Color.White
    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">
    <asp:passwordrecovery id="PasswordRecovery1" runat="server"
      helppagetext="Help with recovering your password" 
      helppageurl="recoveryHelp.aspx" OnUserLookupError="PasswordRecovery1_UserLookupError">
        <hyperlinkstyle backcolor="#E0E0E0"></hyperlinkstyle>
    </asp:passwordrecovery>

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

Remarks

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

Common settings include custom background color, text color, and font properties.

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

The following properties are overridden by HyperLinkStyle settings:

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

Applies to

Jaa