PasswordRecovery.GeneralFailureText Property

  • Reference

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Gets or sets the error message to display when there is a problem with the membership provider for the PasswordRecovery control.

public:
 virtual property System::String ^ GeneralFailureText { System::String ^ get(); void set(System::String ^ value); };
public virtual string GeneralFailureText { get; set; }
member this.GeneralFailureText : string with get, set
Public Overridable Property GeneralFailureText As String

Property Value

String

The error message displayed when the user's password will not be sent by email because of a problem with the membership provider. The default is "Your attempt to retrieve your password has failed. Please try again."

Examples

The following code example sets the GeneralFailureText 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">
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <asp:PasswordRecovery id="PasswordRecovery1" runat="server" 
            GeneralFailureText="You password cannot be retrieved at this time. Please try again later." 
            QuestionFailureText="Your answer does not match the stored answer. Please try again." 
            UserNameFailureText="We couldn't find that user name. Please try again.">
            <FailureTextStyle backcolor="Red" forecolor="White"></FailureTextStyle>
        </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">

    ' Insert page code here
    '

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <asp:PasswordRecovery id="PasswordRecovery1" runat="server" 
            GeneralFailureText="You password cannot be retrieved at this time. Please try again later." 
            QuestionFailureText="Your answer does not match the stored answer. Please try again." 
            UserNameFailureText="We couldn't find that user name. Please try again.">
            <FailureTextStyle backcolor="Red" forecolor="White"></FailureTextStyle>
        </asp:PasswordRecovery>
        <!-- Insert content here -->
    </form>
</body>
</html>

Remarks

The GeneralFailureText property is displayed to the user when there is a problem with the membership provider that manages user information for the PasswordRecovery control. Typically, the GeneralFailureText property is displayed when the membership provider cannot connect to the data store containing user information.

The text specified in the UserNameFailureText property is displayed in the UserName view when the provider cannot find the specified user name in the database. The QuestionFailureText property is displayed in the Question view when the answer entered by the user does not match the stored answer. The GeneralFailureText property is displayed for all other errors.

The appearance of the GeneralFailureText property is defined by the style settings in the FailureTextStyle property.

When you set templates to define the appearance of the PasswordRecovery control, the GeneralFailureText property is displayed in an optional Literal control with the control ID set to "FailureText".

The default text for the property is localized based on the server's locale setting.

The value of this property, when set, can be saved automatically to a resource file by using a designer tool. For more information, see LocalizableAttribute and Globalization and Localization.

Applies to

See also