Login.PasswordRequiredErrorMessage Property

Definition

Gets or sets the error message to display in a ValidationSummary control when the password field is left blank.

public:
 virtual property System::String ^ PasswordRequiredErrorMessage { System::String ^ get(); void set(System::String ^ value); };
public virtual string PasswordRequiredErrorMessage { get; set; }
member this.PasswordRequiredErrorMessage : string with get, set
Public Overridable Property PasswordRequiredErrorMessage As String

Property Value

The error message to display in a ValidationSummary control when the password field is left blank. The default is "Password."

Examples

The following code example uses a ValidationSummary control to display the error message specified in the PasswordRequiredErrorMessage property.

<%@ 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 runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">
            <table>
                <tr>
                    <td>
                        <asp:Login id="Login1" runat="server" 
                            PasswordRequiredErrorMessage="You must enter a password."
                            UserNameRequiredErrorMessage="You must enter a user name.">
                        </asp:Login>
                    </td>
                    <td>
                        <asp:ValidationSummary id="ValidationSummary1" 
                            runat="server" ValidationGroup="Login1" >
                        </asp:ValidationSummary>
                    </td>
                </tr>
            </table>
        </form>
    </body>
</html>
<%@ Page Language="VB"%>
<!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 runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">
            <table>
                <tr>
                    <td>
                        <asp:Login id="Login1" runat="server" 
                            PasswordRequiredErrorMessage="You must enter a password."
                            UserNameRequiredErrorMessage="You must enter a user name.">
                        </asp:Login>
                    </td>
                    <td>
                        <asp:ValidationSummary id="ValidationSummary1" 
                            ValidationGroup="Login1" runat="server">
                        </asp:ValidationSummary>
                    </td>
                </tr>
            </table>
        </form>
    </body>
</html>

Remarks

The PasswordRequiredErrorMessage property contains the error message displayed in a ValidationSummary control on the login page.

The PasswordRequiredErrorMessage property value is displayed only when both the following conditions are true:

  • A ValidationSummary control is present on the page.

  • The Password text box is left blank by the user.

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

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

Both the PasswordRequiredErrorMessage and UserNameRequiredErrorMessage values are wrapped in a validation group within the Login control. For these values to display, the ValidationGroup property of the ValidationSummary control must be set to the ID property of the Login control.

Applies to

See also