Login.FailureText Property


The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets or sets the text displayed when a login attempt fails.

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

public virtual string FailureText { get; set; }

Property Value

Type: System.String

The text to display to the user when a login attempt fails. The default is "Your login attempt has failed. Please try again."

The FailureText property specifies the string that is displayed when a login attempt fails.

If you define a template for the Login control, you can indicate where on the template to display the FailureText property by using a Literal control and giving that control the ID "FailureText". When you use a template, the FailureTextStyle property is not applied to the text specified in the FailureText property.

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


For security reasons, the login failure text should not include a specific reason for the failure. For example, an error message such as "Password not valid for user <username>" reveals to a potential attacker that <username> is a user on the system. For more information, see How to: Display Safe Error Messages.

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 FailureText property to "There was an error while logging you in. Please try again.".

<%@ Page Language="C#" AutoEventWireup="False"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
        <form id="form1" runat="server">
            <asp:Login id="Login1" runat="server" FailureText="There was an error while logging you in. Please try again.">
                <FailureTextStyle ForeColor="White" BackColor="Red"></FailureTextStyle>


.NET Framework
Available since 2.0
Return to top