Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

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.5.1, 4.5, 4, 3.5, 3.0, 2.0

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
© 2014 Microsoft. All rights reserved.