This documentation is archived and is not being maintained.

PasswordRecovery.UserNameFailureText Property

Gets or sets the text displayed when the user name entered by the user is not a valid user name for the Web site.

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

[LocalizableAttribute(true)] 
public virtual string UserNameFailureText { get; set; }
/** @property */
public String get_UserNameFailureText ()

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

public function get UserNameFailureText () : String

public function set UserNameFailureText (value : String)

Not applicable.

Property Value

The text displayed when the user name entered by the user is not a valid user name for the Web site. The default is "We were unable to access your information. Please try again."

The UserNameFailureText property contains the error message that is displayed when the user enters a user name that is not recognized by the membership provider defined in the MembershipProvider property.

The style settings in the FailureTextStyle property define the appearance of the text in the UserNameFailureText property.

When you assign a template to the UserNameTemplate property, the UserNameFailureText property is displayed in an optional Literal control with the ID property 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 UserNameFailureText property to "We couldn't find that user name. Please try again."

<%@ 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>

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
Show: