Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
GeneralFailureText Property

PasswordRecovery.GeneralFailureText Property

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

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

public virtual string GeneralFailureText { get; set; }
<asp:PasswordRecovery GeneralFailureText="String" />

Property Value

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

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 ASP.NET Globalization and Localization.

The following code example sets the GeneralFailureText property.

<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
<script runat="server">
<html xmlns="http://www.w3.org/1999/xhtml" >
    <title>ASP.NET Example</title>
    <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>

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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

Community Additions

© 2015 Microsoft