Export (0) Print
Expand All

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; }
/** @property */
public String get_GeneralFailureText ()

/** @property */
public void set_GeneralFailureText (String value)

public function get GeneralFailureText () : String

public function set GeneralFailureText (value : String)

Not applicable.

Property Value

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>

Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

Community Additions

© 2014 Microsoft