Login.FailureAction Propriedade

  • Referência

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtém ou define a ação que ocorre quando uma tentativa de logon falha.

public:
 virtual property System::Web::UI::WebControls::LoginFailureAction FailureAction { System::Web::UI::WebControls::LoginFailureAction get(); void set(System::Web::UI::WebControls::LoginFailureAction value); };
[System.Web.UI.Themeable(false)]
public virtual System.Web.UI.WebControls.LoginFailureAction FailureAction { get; set; }
[<System.Web.UI.Themeable(false)>]
member this.FailureAction : System.Web.UI.WebControls.LoginFailureAction with get, set
Public Overridable Property FailureAction As LoginFailureAction

Valor da propriedade

LoginFailureAction

Um dos valores de enumeração LoginFailureAction. O padrão é Refresh.

Atributos
ThemeableAttribute

Exceções

ArgumentOutOfRangeException

O valor selecionado não é um dos valores de enumeração LoginFailureAction.

Exemplos

O exemplo de código a seguir mostra como definir a FailureAction propriedade declarativamente e no código.

<%@ 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">
void Page_Load(Object sender, EventArgs e)
{
    Login1.FailureAction = LoginFailureAction.RedirectToLoginPage;
}

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">
            <asp:Login id="Login1" runat="server" FailureAction="RedirectToLoginPage"></asp:Login>
        </form>
    </body>
</html>

<%@ Page Language="VB" 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">
Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
    Login1.FailureAction = LoginFailureAction.RedirectToLoginPage
End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">
            <asp:Login id="Login1" runat="server" FailureAction="RedirectToLoginPage"></asp:Login>
        </form>
    </body>
</html>

Comentários

A FailureAction propriedade define o comportamento do Login controle quando o usuário não faz logon com êxito no site.

O comportamento padrão recarrega a página e exibe o conteúdo da FailureText propriedade para alertar o usuário de que a tentativa de logon falhou.

Quando FailureAction é definido como RedirectToLoginPage, o usuário é redirecionado para a página de logon definida no arquivo Web.config.

Essa propriedade não pode ser definida por temas ou temas de folha de estilos. Para obter mais informações, consulte ThemeableAttribute e ASP.NET Temas e Peles.

Aplica-se a

Confira também