HomePage Biblioteca Aprender Downloads Suporte Comunidade
Entrar | United States - English | |
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original
Este tópico ainda não foi avaliado como Avalie este tópico

Classe FormsAuthentication

.NET Framework 4

Gerencia os serviços de autenticação de formulários para aplicativos da Web. Esta classe não pode ser herdada.

System.Object
  System.Web.Security.FormsAuthentication

Namespace:  System.Web.Security
Assembly:  System.Web (em System.Web.dll)
C#
C++
F#
VB
Copiar 
public sealed class FormsAuthentication

O tipo FormsAuthentication expõe os membros a seguir.

  Nome Descrição
Método público FormsAuthentication Initializes a new instance of the FormsAuthentication class.
Início
  Nome Descrição
Propriedade pública Membro estático CookieDomain Obtém o valor do domínio do cookie de autenticação de formulários.
Propriedade pública Membro estático CookieMode Gets a value that indicates whether the application is configured for cookieless forms authentication.
Propriedade pública Membro estático CookiesSupported Gets a value that indicates whether the application is configured to support cookieless forms authentication.
Propriedade pública Membro estático DefaultUrl Obtém o URL que o FormsAuthentication classe não redirecionará se nenhum redirecionamento de URL for especificada.
Propriedade pública Membro estático EnableCrossAppRedirects Obtém um valor que indica se os usuários autenticados podem ser redirecionados para URLs em outros aplicativos da Web.
Propriedade pública Membro estático FormsCookieName Obtém o nome do cookie usado para armazenar o tíquete de autenticação de formulários.
Propriedade pública Membro estático FormsCookiePath Obtém o caminho para o cookie de autenticação de formulários.
Propriedade pública Membro estático IsEnabled
Propriedade pública Membro estático LoginUrl Obtém o URL para a página de logon que o FormsAuthentication classe será redirecionada para.
Propriedade pública Membro estático RequireSSL Obtém um valor indicando se o cookie de autenticação de formulários exige SSL para ser retornada para o servidor.
Propriedade pública Membro estático SlidingExpiration Gets a value indicating whether sliding expiration is enabled.
Propriedade pública Membro estático TicketCompatibilityMode
Propriedade pública Membro estático Timeout
Início
  Nome Descrição
Método público Membro estático Authenticate Valida um nome de usuário e senha contra as credenciais armazenadas no arquivo de configuração para um aplicativo.
Método público Membro estático Decrypt Cria um FormsAuthenticationTicket objeto baseado no tíquete de autenticação de formulários criptografado passado para o método.
Método público Membro estático EnableFormsAuthentication
Método público Membro estático Encrypt Cria uma seqüência de caracteres contendo um tíquete de autenticação de formulários criptografado adequado para uso em um cookie HTTP.
Método público Equals(Object) Determina se o Object especificado é igual ao Object atual. (Herdado de Object.)
Método protegido Finalize Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes que ele seja recuperado pela coleta de lixo. (Herdado de Object.)
Método público Membro estático GetAuthCookie(String, Boolean) Cria um cookie de autenticação para um nome de usuário fornecido. Isso não define o cookie como parte da resposta de saída, para que um aplicativo pode ter mais controle sobre como o cookie é emitido.
Método público Membro estático GetAuthCookie(String, Boolean, String) Cria um cookie de autenticação para um nome de usuário fornecido. Isso não define o cookie como parte da resposta de saída.
Método público GetHashCode Serve como uma função hash para um tipo específico. (Herdado de Object.)
Método público Membro estático GetRedirectUrl Retorna o URL de redirecionamento para a solicitação original que causou o redirecionamento para a página de login.
Método público GetType Obtém o Type da instância atual. (Herdado de Object.)
Método público Membro estático HashPasswordForStoringInConfigFile Produz uma senha de hash adequada para armazenar em um arquivo de configuração com base na senha especificada e o algoritmo de hash.
Método público Membro estático Initialize Inicializa o FormsAuthentication objeto baseado nas definições de configuração para o aplicativo.
Método protegido MemberwiseClone Cria uma cópia superficial do Object atual. (Herdado de Object.)
Método público Membro estático RedirectFromLoginPage(String, Boolean) Redireciona o usuário autenticado para a URL solicitada originalmente ou a URL padrão.
Método público Membro estático RedirectFromLoginPage(String, Boolean, String) Redireciona o usuário autenticado para a URL solicitada originalmente ou a URL padrão usando o caminho do cookie especificado para o cookie de autenticação de formulários.
Método público Membro estático RedirectToLoginPage Redireciona o navegador a URL de login.
Método público Membro estático RedirectToLoginPage(String) Redireciona o navegador a URL de login com a seqüência de caracteres de consulta especificada.
Método público Membro estático RenewTicketIfOld Condicionalmente atualiza a data de emissão e tempo e data de expiração e para um FormsAuthenticationTicket.
Método público Membro estático SetAuthCookie(String, Boolean) Cria um tíquete de autenticação para o nome de usuário fornecido e o adiciona à coleção de cookies de resposta ou a URL se você estiver usando autenticação cookieless.
Método público Membro estático SetAuthCookie(String, Boolean, String) Cria um tíquete de autenticação para o nome de usuário fornecido e o adiciona à coleção de cookies de resposta, usando o caminho do cookie fornecido ou o URL se você estiver usando autenticação cookieless.
Método público Membro estático SignOut Remove o tíquete de autenticação de formulários do navegador.
Método público ToString Retorna uma string que representa o objeto atual. (Herdado de Object.)
Início

Autenticação de formulários permite que a validação de usuário e de senha para aplicativos da Web não necessitem de autenticação do Windows. Com a autenticação de formulários, informações do usuário são armazenadas em uma fonte de dados externos, como um Membership banco de dados, ou no arquivo de configuração para um aplicativo. Quando um usuário é autenticado, a autenticação de formulários mantém um tíquete de autenticação em um cookie ou a URL para que um usuário autenticado não precisa fornecer credenciais com cada solicitação.

Autenticação de formulários está habilitada, definindo a mode atributo o autenticação o elemento de configuração para Forms. Você pode exigir que todas as solicitações para um aplicativo contêm um tíquete de autenticação de usuário válido usando o autorização o elemento de configuração para negar a solicitação de qualquer usuário desconhecido, conforme mostrado no exemplo a seguir.

Copiar 
<system.web>
  <authentication mode="Forms">
    <forms loginUrl="login.aspx" />
  </authentication>
  <authorization>
    <deny users="?" />
  </authorization>
</system.web>

No exemplo anterior, qualquer solicitação para uma página ASP.NET que é parte do aplicativo requer um nome de usuário válido que é fornecido pela autenticação de formulários. Se nenhum nome de usuário existe, então, a solicitação é redirecionada para o configurado LoginUrl.

O FormsAuthentication classe fornece acesso a métodos e propriedades que você pode usar em um aplicativo que autentica os usuários. O RedirectToLoginPage método redireciona o navegador configurados LoginUrl para os usuários façam logon em um aplicativo. O RedirectFromLoginPage método redireciona o usuário autenticado volta para o URL protegido original que foi solicitada ou a DefaultUrl. Também são métodos que permitem gerenciar permissões de autenticação de formulários, se necessário.

TopicLocation
Demonstra Passo a passo: Criar um site da Web com o membro e de logon do usuário (Visual Studio)dv_vwdcon
Como: Implement Simples Formulários Authenticationdv_aspnetcon
Como: Use of the Controlar Logon ASP.NET Avançado Featuresdv_aspnetcon
Como: Criar uma página de logon ASP.NETdv_aspnetcon
Como: Implementar autenticação de formulários simplesBuilding ASP .NET Web Applications in Visual Studio
Como: Usar recursos avançados do controle de login ASP.NETBuilding ASP .NET Web Applications in Visual Studio
Como: Criar uma página de login ASP.NETBuilding ASP .NET Web Applications in Visual Studio
Passo a passo: Criando um Site com Associação e Logon de Usuário (Visual Studio)dv_vwdcon
Como: implementar a autenticação de formulários simplesdv_vwdcon
Como: usar recursos avançados do controle de logon do ASP.NETdv_vwdcon
Como: Criar uma página de Logon asp.NETdv_vwdcon

O exemplo de código a seguir mostra o arquivo Web. config para um aplicativo ASP.NET que usa o ASP.NET membership provider para autenticação de formulários e exige que todos os usuários sejam autenticados.

Copiar 
<configuration>
  <connectionStrings>
    <add name="SqlServices" connectionString="Data Source=MySqlServer;Integrated Security=SSPI;Initial Catalog=aspnetdb;" />
  </connectionStrings>
  <system.web>
    <membership defaultProvider="SqlProvider" userIsOnlineTimeWindow="20">
      <providers>
        <add name="SqlProvider"
          type="System.Web.Security.SqlMembershipProvider"
          connectionStringName="SqlServices"
          enablePasswordRetrieval="false"
          enablePasswordReset="true"
          requiresQuestionAndAnswer="true"
          passwordFormat="Hashed"
          applicationName="/" />
      </providers>
    </membership>
  </system.web>
</configuration>

O exemplo de código a seguir mostra a página de logon para um aplicativo ASP.NET que usa autenticação forms e ASP.NET membership.

Observação de segurançaObservação sobre segurança

This example contains a text box that accepts user input, which is a potential security threat. Por padrão, páginas Web ASP.NET validam se as entradas de usuário não incluem scripts ou elementos HTML. Para mais informações, acesse Visão Geral de Scripts Maliciosos.

C#
VB
Copiar 

<%@ Page Language="C#" %>
<%@ Import Namespace="System.Web.Security" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

public void Login_OnClick(object sender, EventArgs args)
{
   if (Membership.ValidateUser(UsernameTextbox.Text, PasswordTextbox.Text))
      FormsAuthentication.RedirectFromLoginPage(UsernameTextbox.Text, NotPublicCheckBox.Checked);
   else
     Msg.Text = "Login failed. Please check your user name and password and try again.";
}


</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
  <title>Login</title>
</head>
<body>

<form id="form1" runat="server">
  <h3>Login</h3>

  <asp:Label id="Msg" ForeColor="maroon" runat="server" /><br />

  Username: <asp:Textbox id="UsernameTextbox" runat="server" /><br />
  Password: <asp:Textbox id="PasswordTextbox" runat="server" TextMode="Password" /><br />

  <asp:Button id="LoginButton" Text="Login" OnClick="Login_OnClick" runat="server" />
  <asp:CheckBox id="NotPublicCheckBox" runat="server" /> 
  Check here if this is <span style="text-decoration:underline">not</span> a public computer.

</form>

</body>
</html>

.NET Framework

Com suporte em: 4, 3.5, 3.0, 2.0, 1.1, 1.0
  • AspNetHostingPermission  

    Para usar o FormsAuthentication a classe em um ambiente hospedado. Demand value: LinkDemand. Valor de permissão: Minimal.

Windows 7, Windows Vista SP1 ou posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core não compatível), Windows Server 2008 R2 (Server Core não compatível com SP1 ou posterior), Windows Server 2003 SP2

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos de sistema do .NET Framework.
Quaisquer membros static (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.
Isso foi útil para você?
(2000 caracteres restantes)
Conteúdo da Comunidade Adicionar
Anotações Perguntas frequentes