Login.UserNameRequiredErrorMessage Propriedade

Definição

Espaço de Nomes:
System.Web.UI.WebControls
Assemblagem:
System.Web.dll

Recebe ou define a mensagem de erro para ser exibida num ValidationSummary controlo quando o campo do nome de utilizador fica em branco.

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

Valor de Propriedade

String

A mensagem de erro deve ser exibida num ValidationSummary controlo quando o campo do nome de utilizador fica em branco. O padrão é "Nome de Utilizador."

Exemplos

O exemplo de código seguinte demonstra a utilização de um ValidationSummary controlo para mostrar a mensagem de erro especificada na UserNameRequiredErrorMessage propriedade.

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

Observações

A UserNameRequiredErrorMessage propriedade contém a mensagem de erro exibida num ValidationSummary controlo na página de login.

O UserNameRequiredErrorMessage valor da propriedade é exibido apenas quando ambas as seguintes condições são verdadeiras:

  • Um ValidationSummary controlo está presente na página.

  • A caixa de texto do nome de utilizador é deixada em branco pelo utilizador.

O texto padrão para o controlo é localizado com base na localização atual do servidor.

O valor desta propriedade, quando definido, pode ser guardado automaticamente num ficheiro de recurso usando uma ferramenta de design. Para mais informações, veja LocalizableAttributeGlobalização e Localização.

Ambos os PasswordRequiredErrorMessage valores e UserNameRequiredErrorMessage estão encapsulados num grupo de validação dentro do Login controlo. Para que estes valores sejam exibidos, a ValidationGroup propriedade do ValidationSummary controlo deve ser definida para a ID propriedade do Login controlo.

Aplica-se a

Ver também