Exportar (0) Imprimir
Expandir Tudo
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

Classe FormsAuthenticationTicket

Fornece acesso a propriedades e valores do tíquete usado com a autenticação de formulários para identificar usuários de. Esta classe não pode ser herdada.

System.Object
  System.Web.Security.FormsAuthenticationTicket

Namespace:  System.Web.Security
Assembly:  System.Web (em System.Web.dll)

[SerializableAttribute]
public sealed class FormsAuthenticationTicket

O tipo FormsAuthenticationTicket expõe os membros a seguir.

  NomeDescrição
Método públicoFormsAuthenticationTicket(String, Boolean, Int32)Inicializa uma nova instância da FormsAuthenticationTicket de classe usando as informações de nome e a expiração de uma cookie.
Método públicoFormsAuthenticationTicket(Int32, String, DateTime, DateTime, Boolean, String)Inicializa uma nova instância da FormsAuthenticationTicket classe com o nome do cookie, versão, data de vencimento, data de emissão, persistência e dados específicos do usuário. O caminho do cookie é definido como o valor padrão estabelecido no arquivo de configuração do aplicativo.
Método públicoFormsAuthenticationTicket(Int32, String, DateTime, DateTime, Boolean, String, String)Inicializa uma nova instância da FormsAuthenticationTicket classe com o nome do cookie, versão, o caminho de diretório, a data de emissão, data de validade, persistência e dados definidos pelo usuário.
Superior

  NomeDescrição
Propriedade públicaCookiePathObtém o caminho do cookie para o tíquete de autenticação de formulários.
Propriedade públicaExpirationObtém a data e hora local no qual o tíquete de autenticação de formulários expira.
Propriedade públicaExpiredObtém um valor indicando se o tíquete de autenticação de formulários expirou.
Propriedade públicaIsPersistentObtém um valor indicando se o cookie que contém as informações do tíquete de autenticação de formulários é persistente.
Propriedade públicaIssueDateObtém a data e hora local no qual o tíquete de autenticação de formulários foi originalmente emitido.
Propriedade públicaNameObtém o nome de usuário associado com o tíquete de autenticação de formulários.
Propriedade públicaUserData Obtém uma string do usuário específico armazenada com o tíquete.
Propriedade públicaVersion Obtém o número de versão do tíquete.
Superior

  NomeDescrição
Método públicoEquals(Object) Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)
Método públicoGetHashCodeServe como a função de hash padrão. (Herdado de Object.)
Método públicoGetType Obtém o Type da instância atual. (Herdado de Object.)
Método públicoToStringRetorna uma string que representa o objeto atual. (Herdado de Object.)
Superior

A classe FormsAuthenticationTicket é usada para criar um objeto que representa o tíquete de autenticação que é usado pela autenticação de formulários para identificar um usuário autenticado.
As propriedades e valores de um tíquete de autenticação de formulários são convertidos em uma seqüência de caracteres criptografada armazenada em um cookie ou a URL.

A classe FormsAuthentication fornece um método Encrypt para criar um valor de seqüência de caracteres que pode ser armazenado em um cookie ou na URL de um FormsAuthenticationTicket.
A classe FormsAuthentication também fornece um Decrypt para criar um objeto FormsAuthenticationTicket do tíquete de autenticação criptografada recuperado do cookie de autenticação de formulários ou a URL.

O FormsAuthenticationTicket para o usuário autenticado atualmente pode ser acessado usando a propriedade Ticket da classe FormsIdentity . Você pode acessar o atual FormsIdentity o objeto ao convertê a Identity a propriedade do atual User como tipo de FormsIdentity.

O exemplo de código a seguir armazena o resultado do Encrypt método em um cookie usando o FormsCookieName e redireciona o usuário para a URL retornada do GetRedirectUrl método.

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

Este exemplo contem uma caixa de texto que aceita entradas do usuário, que é uma potencial ameaça de segurança. 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, consulte Visão Geral de Scripts Maliciosos.


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

  private void Login_Click(Object sender, EventArgs e)
  {
    // Create a custom FormsAuthenticationTicket containing
    // application specific data for the user.

    string username     = UserNameTextBox.Text;
    string password     = UserPassTextBox.Text;
    bool   isPersistent = false;

    if (Membership.ValidateUser(username, password))
    {
      string userData = "ApplicationSpecific data for this user.";

      FormsAuthenticationTicket ticket = new FormsAuthenticationTicket(1,
        username,
        DateTime.Now,
        DateTime.Now.AddMinutes(30),
        isPersistent,
        userData,
        FormsAuthentication.FormsCookiePath);

      // Encrypt the ticket.
      string encTicket = FormsAuthentication.Encrypt(ticket);

      // Create the cookie.
      Response.Cookies.Add(new HttpCookie(FormsAuthentication.FormsCookieName, encTicket));

      // Redirect back to original URL.
      Response.Redirect(FormsAuthentication.GetRedirectUrl(username, isPersistent));
    }
    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>Forms Authentication Login</title>
</head>
<body>
    <form id="form1" runat="server">
        <span style="BACKGROUND: #80ff80; font-weight:bold"> 
            Login Page
        </span> 
        <asp:Label id="Msg" ForeColor="maroon" runat="server" /><br />
        <table border="0">
            <tbody>
                <tr>
                    <td>Username:</td>
                    <td><asp:TextBox id="UserNameTextBox" runat="server" /></td>
                    <td>
                      <asp:RequiredFieldValidator id="RequiredFieldValidator1" 
                                                  runat="server" ErrorMessage="*" 
                                                  Display="Static" 
                                                  ControlToValidate="UserNameTextBox" />
                    </td>
                </tr>
                <tr>
                    <td>Password:</td>
                    <td><asp:TextBox id="UserPassTextBox" TextMode="Password" runat="server" /></td>
                    <td>
                      <asp:RequiredFieldValidator id="RequiredFieldValidator2" 
                                                  runat="server" ErrorMessage="*" 
                                                  Display="Static" 
                                                  ControlToValidate="UserPassTextBox" />
                    </td>
                </tr>
            </tbody>
        </table>
        <input type="submit" value="Login" runat="server" onserverclick="Login_Click" />
    </form>
</body>
</html>


.NET Framework

Com suporte em: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

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 do sistema do .NET Framework.

Quaisquer membros estático (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.

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2014 Microsoft