FormsIdentity Classe

Definição

Namespace:: System.Web.Security

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Representa uma identidade de usuário autenticada usando a autenticação de formulários. Essa classe não pode ser herdada.

public ref class FormsIdentity sealed : System::Security::Principal::IIdentity

public ref class FormsIdentity : System::Security::Principal::IIdentity

public ref class FormsIdentity : System::Security::Claims::ClaimsIdentity

[System.Serializable]
public sealed class FormsIdentity : System.Security.Principal.IIdentity

[System.Serializable]
public class FormsIdentity : System.Security.Principal.IIdentity

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(false)]
public class FormsIdentity : System.Security.Claims.ClaimsIdentity

[<System.Serializable>]
type FormsIdentity = class
    interface IIdentity

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(false)>]
type FormsIdentity = class
    inherit ClaimsIdentity

Public NotInheritable Class FormsIdentity
Implements IIdentity

Public Class FormsIdentity
Implements IIdentity

Public Class FormsIdentity
Inherits ClaimsIdentity

Herança: Object
FormsIdentity

Herança: Object

ClaimsIdentity
FormsIdentity

Atributos: SerializableAttribute ComVisibleAttribute

Implementações: IIdentity

Exemplos

O exemplo de código a seguir gera um FormsAuthenticationTicket e o usa para criar uma instância da FormsIdentity classe, com base em se o usuário fornece o nome de usuário e a senha corretos no formulário.

<%@ Page Language="C#" %>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<%@ Import Namespace="System.Globalization" %>
<%@ Import Namespace="System.Web.Security" %>
<script runat="server">
    protected void Login_Click(object sender, EventArgs e)
    {
        bool isAuthenticated = false;
        if (string.Compare(UserNameTextBox.Text, "UserName", true,
        CultureInfo.InvariantCulture) == 0)
        {
            if (string.Compare(PasswordTextBox.Text, "Password", true,
            CultureInfo.InvariantCulture) == 0)
            {
                isAuthenticated = true;
            }
        }
        else isAuthenticated = false;
        
        // Create the formsIdentity for the user.
        CreateformsIdentity(UserNameTextBox.Text, isAuthenticated);
    }
    private void CreateformsIdentity(string userName, bool isAuthenticated)
    {
        FormsIdentity formsID;
        FormsAuthenticationTicket authenticationTicket;
        
        if (isAuthenticated)
        {
            // If authentication passed, create a ticket 
            // as a Manager that expires in 15 minutes.
            authenticationTicket = new FormsAuthenticationTicket(1, userName,
                DateTime.Now, DateTime.Now.AddMinutes(15), false, "Manager");
        }
        else
        {
            // If authentication failed, create a ticket 
            // as a guest that expired 5 minutes ago.
            authenticationTicket = new FormsAuthenticationTicket(1, userName,
                DateTime.Now, DateTime.Now.Subtract(new TimeSpan(0, 5, 0)),
                false, "Guest");
        }

        // Create form identity from FormsAuthenticationTicket.
        formsID = new FormsIdentity(authenticationTicket);
        Response.Clear();
        Response.Write("Authentication Type: " + formsID.AuthenticationType +
            "<BR>");

        // Get FormsAuthenticationTicket from the FormIdentity
        FormsAuthenticationTicket ticket = formsID.Ticket;
        if (ticket.Expired)
        {
            Response.Write("Authentication failed, so the role is set to " +
                ticket.UserData);
        }
        else
        {
            Response.Write("Authentication succeeded, so the role is set to " +
                ticket.UserData);
        }
    }
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
    <head>
        <title>WebForm1</title>
    </head>
    <body>
        <form id="Form1" method="post" runat="server">
            <asp:Label id="UserIdLabel" runat="server"
                style="left: 144px; position: absolute; top: 160px">
                User-ID:</asp:Label>
            <asp:Label id="PasswordLabel" runat="server"
                style="left: 144px; position: absolute; top: 200px">
                Password:</asp:Label>
            <asp:TextBox id="UserNameTextBox" runat="server"
                style="left: 232px; position: absolute; top: 160px;
                width:182px; height:22px"></asp:TextBox>
            <asp:TextBox id="PasswordTextBox" runat="server"
                style="left: 232px; position: absolute; top: 200px;
                width:181px; height:22px" TextMode="Password">
                </asp:TextBox>
            <asp:Button id="Login" runat="server" Text="Login"
                style="left: 232px; position: absolute; top: 232px; 
                width:100px" OnClick="Login_Click"></asp:Button>
        </form>
    </body>
</html>

<%@ Page Language="vb" %>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<%@ Import Namespace="System.Globalization" %>
<script runat="server">
    Private Sub Login_Click(ByVal sender As System.Object, _
        ByVal e As System.EventArgs) Handles Login.Click

        ' For the example, the user name must be "UserName" and the password
        ' must be "Password" for authentication to succeed.
        Dim isAuthenticated As Boolean
        If String.Compare(UserNameTextBox.Text, "UserName", True, _
            CultureInfo.InvariantCulture) = 0 Then
            If String.Compare(PasswordTextBox.Text, "Password", True, _
                CultureInfo.InvariantCulture) = 0 Then
                isAuthenticated = True
            End If
        Else
            isAuthenticated = False
        End If

        ' Create the FormsIdentity for the user.
        CreateFormsIdentity(UserNameTextBox.Text, isAuthenticated)

    End Sub

    Private Sub CreateFormsIdentity(ByVal userName As String, _
        ByVal isAuthenticated As Boolean)

        Dim formsId As System.Web.Security.FormsIdentity
        Dim authenticationTicket As _
            System.Web.Security.FormsAuthenticationTicket

        If isAuthenticated Then
            ' If authentication passed, create a ticket 
            ' as a Manager that expires in 15 minutes.
            authenticationTicket = _
                New FormsAuthenticationTicket(1, userName, DateTime.Now, _
                DateTime.Now.AddMinutes(15), False, "Manager")
        Else
            ' If authentication failed, create a ticket 
            ' as a guest that expired 5 minutes ago.
            authenticationTicket = _
                New FormsAuthenticationTicket(1, userName, DateTime.Now, _
                DateTime.Now.Subtract(New TimeSpan(0, 5, 0)), False, "Guest")
        End If

        ' Create form identity from FormsAuthenticationTicket.
        formsId = New FormsIdentity(authenticationTicket)

        Response.Clear()
        Response.Write("Authenticate Type: " & _
            formsId.AuthenticationType & "<BR>")

        ' Get FormsAuthenticationTicket from the FormIdentity
        Dim ticket As FormsAuthenticationTicket = formsId.Ticket()
        If ticket.Expired Then
            Response.Write("Authentication failed, so the role is set to " & _
                ticket.UserData)
        Else
            Response.Write("Authentication succeeded, so the role is set to " & _
                ticket.UserData)
        End If
    End Sub

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
    <head>
        <title>WebForm1</title>
    </head>
    <body>
        <form id="Form1" method="post" runat="server">
            <asp:Label id="UserIdLabel" runat="server"
                style="left: 144px; position: absolute; top: 160px">
                User-ID:</asp:Label>
            <asp:Label id="PasswordLabel" runat="server"
                style="left: 144px; position: absolute; top: 200px">
                Password:</asp:Label>
            <asp:TextBox id="UserNameTextBox" runat="server"
                style="left: 232px; position: absolute; top: 160px;
                width:182px; height:22px"></asp:TextBox>
            <asp:TextBox id="PasswordTextBox" runat="server"
                style="left: 232px; position: absolute; top: 200px;
                width:181px; height:22px" TextMode="Password">
                </asp:TextBox>
            <asp:Button id="Login" runat="server" Text="Login"
                style="left: 232px; position: absolute; top: 232px; 
                width:100px"></asp:Button>
        </form>
    </body>
</html>

Comentários

A FormsIdentity classe é usada pelo momento em que FormsAuthenticationModule um usuário é autenticado com autenticação de formulários. Uma instância da FormsIdentity classe é criada usando a FormsAuthenticationTicket que é descriptografada do cookie de autenticação de formulários ou da URL. A nova instância da FormsIdentity classe é usada para construir um novo GenericPrincipal objeto que é definido como o valor da User propriedade para o atual HttpContext.

Construtores

Nome	Description
FormsIdentity(FormsAuthenticationTicket)	Inicializa uma nova instância da classe FormsIdentity.
FormsIdentity(FormsIdentity)	Inicializa uma nova instância da FormsIdentity classe com base na identidade especificada.

Campos

Nome	Description
DefaultIssuer	O emissor padrão; "AUTORIDADE LOCAL". (Herdado de ClaimsIdentity)
DefaultNameClaimType	O tipo de declaração de nome padrão; Name. (Herdado de ClaimsIdentity)
DefaultRoleClaimType	O tipo de declaração de função padrão; Role. (Herdado de ClaimsIdentity)

Propriedades

Nome	Description
Actor	Obtém ou define a identidade da parte chamada que recebeu direitos de delegação. (Herdado de ClaimsIdentity)
AuthenticationType	Obtém o tipo de identidade autenticada.
BootstrapContext	Obtém ou define o token que foi usado para criar essa identidade de declarações. (Herdado de ClaimsIdentity)
Claims	Obtém a coleção de declarações associadas a essa identidade.
CustomSerializationData	Contém quaisquer dados adicionais fornecidos por um tipo derivado. Normalmente definido ao chamar WriteTo(BinaryWriter, Byte[]). (Herdado de ClaimsIdentity)
IsAuthenticated	Obtém um valor que indica se a autenticação ocorreu.
Label	Obtém ou define o rótulo dessa identidade de declaração. (Herdado de ClaimsIdentity)
Name	Obtém o nome de usuário da identidade dos formulários.
NameClaimType	Obtém o tipo de declaração usado para determinar quais declarações fornecem o valor para a Name propriedade dessa identidade de declaração. (Herdado de ClaimsIdentity)
RoleClaimType	Obtém o tipo de declaração que será interpretado como uma função .NET entre as declarações nessa identidade de declaração. (Herdado de ClaimsIdentity)
Ticket	Obtém a FormsAuthenticationTicket identidade do usuário de autenticação de formulários.

Métodos

Nome	Description
AddClaim(Claim)	Adiciona uma única declaração a essa identidade de declarações. (Herdado de ClaimsIdentity)
AddClaims(IEnumerable<Claim>)	Adiciona uma lista de declarações a essa identidade de declarações. (Herdado de ClaimsIdentity)
Clone()	Obtém uma cópia da instância atual FormsIdentity .
CreateClaim(BinaryReader)	Fornece um ponto de extensibilidade para tipos derivados criarem um personalizado Claim. (Herdado de ClaimsIdentity)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
FindAll(Predicate<Claim>)	Recupera todas as declarações correspondentes ao predicado especificado. (Herdado de ClaimsIdentity)
FindAll(String)	Recupera todas as declarações que têm o tipo de declaração especificado. (Herdado de ClaimsIdentity)
FindFirst(Predicate<Claim>)	Recupera a primeira declaração que é correspondida pelo predicado especificado. (Herdado de ClaimsIdentity)
FindFirst(String)	Recupera a primeira declaração com o tipo de declaração especificado. (Herdado de ClaimsIdentity)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetObjectData(SerializationInfo, StreamingContext)	Preenche os SerializationInfo dados necessários para serializar o objeto atual ClaimsIdentity . (Herdado de ClaimsIdentity)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
HasClaim(Predicate<Claim>)	Determina se essa identidade de declaração tem uma declaração que é correspondida pelo predicado especificado. (Herdado de ClaimsIdentity)
HasClaim(String, String)	Determina se essa identidade de declaração tem uma declaração com o tipo de declaração e o valor especificados. (Herdado de ClaimsIdentity)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
RemoveClaim(Claim)	Tenta remover uma declaração da identidade das declarações. (Herdado de ClaimsIdentity)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
TryRemoveClaim(Claim)	Tenta remover uma declaração da identidade das declarações. (Herdado de ClaimsIdentity)
WriteTo(BinaryWriter, Byte[])	Serializa usando um BinaryWriter. (Herdado de ClaimsIdentity)
WriteTo(BinaryWriter)	Serializa usando um BinaryWriter. (Herdado de ClaimsIdentity)

Aplica-se a

Confira também

Provedor de Autenticação de Formulários

Comentários

Esta página foi útil?

Partilhar via

FormsIdentity Classe

Definição

Exemplos

Comentários

Construtores

Campos

Propriedades

Métodos

Aplica-se a

Confira também

Comentários