FormsIdentity Třída

Reference

Definice

Obor názvů:: System.Web.Security

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Představuje identitu uživatele ověřenou pomocí ověřování pomocí formulářů. Tato třída se nemůže dědit.

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

Dědičnost: Object
FormsIdentity

Dědičnost: Object

ClaimsIdentity
FormsIdentity

Atributy: SerializableAttribute ComVisibleAttribute

Implementuje: IIdentity

Příklady

Následující příklad kódu vygeneruje FormsAuthenticationTicket a pak ho použije k vytvoření instance FormsIdentity třídy na základě toho, jestli uživatel do formuláře zadá správné uživatelské jméno a heslo.

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

Poznámky

Třída FormsIdentity se používá, FormsAuthenticationModule když je uživatel ověřen pomocí ověřování pomocí formulářů. Instance třídy se vytvoří pomocí objektu FormsIdentity FormsAuthenticationTicket , který je dešifrován ze souboru cookie ověřování formulářů nebo z adresy URL. Nová instance FormsIdentity třídy se používá k vytvoření nového GenericPrincipal objektu, který je nastaven jako hodnota User vlastnosti pro aktuální HttpContext.

Konstruktory

FormsIdentity(FormsAuthenticationTicket)	Inicializuje novou instanci FormsIdentity třídy.
FormsIdentity(FormsIdentity)	Inicializuje novou instanci FormsIdentity třídy na základě zadané identity.

Pole

DefaultIssuer	Výchozí vystavitel; "MÍSTNÍ ORGÁN". (Zděděno od ClaimsIdentity)
DefaultNameClaimType	Výchozí typ deklarace identity názvu; Name. (Zděděno od ClaimsIdentity)
DefaultRoleClaimType	Výchozí typ deklarace identity role; Role. (Zděděno od ClaimsIdentity)

Vlastnosti

Actor	Získá nebo nastaví identitu volající strany, které byla udělena práva delegování. (Zděděno od ClaimsIdentity)
AuthenticationType	Získá typ ověřené identity.
BootstrapContext	Získá nebo nastaví token, který byl použit k vytvoření této identity deklarací identity. (Zděděno od ClaimsIdentity)
Claims	Získá kolekci deklarací identity, které jsou přidruženy k této identitě.
CustomSerializationData	Obsahuje všechna další data poskytnutá odvozeným typem. Obvykle se nastavuje při volání WriteTo(BinaryWriter, Byte[]). (Zděděno od ClaimsIdentity)
IsAuthenticated	Získá hodnotu, která označuje, zda proběhlo ověřování.
Label	Získá nebo nastaví popisek pro tuto identitu deklarací identity. (Zděděno od ClaimsIdentity)
Name	Získá uživatelské jméno identity formulářů.
NameClaimType	Získá typ deklarace identity, který se používá k určení, které deklarace identity poskytují hodnotu pro Name vlastnost této identity deklarací identity. (Zděděno od ClaimsIdentity)
RoleClaimType	Získá typ deklarace identity, který bude interpretován jako role .NET mezi deklaracemi v této identitě deklarací identity. (Zděděno od ClaimsIdentity)
Ticket	FormsAuthenticationTicket Získá pro identitu uživatele ověřování formulářů.

Metody

AddClaim(Claim)	Přidá k této identitě deklarací identity jednu deklaraci identity. (Zděděno od ClaimsIdentity)
AddClaims(IEnumerable<Claim>)	Přidá do této identity deklarací identity seznam deklarací identity. (Zděděno od ClaimsIdentity)
Clone()	Získá kopii aktuální FormsIdentity instance.
CreateClaim(BinaryReader)	Poskytuje bod rozšiřitelnosti pro odvozené typy pro vytvoření vlastní Claim. (Zděděno od ClaimsIdentity)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
FindAll(Predicate<Claim>)	Načte všechny deklarace identity, které odpovídají zadanému predikátu. (Zděděno od ClaimsIdentity)
FindAll(String)	Načte všechny deklarace identity, které mají zadaný typ deklarace identity. (Zděděno od ClaimsIdentity)
FindFirst(Predicate<Claim>)	Načte první deklaraci identity odpovídající zadanému predikátu. (Zděděno od ClaimsIdentity)
FindFirst(String)	Načte první deklaraci identity se zadaným typem deklarace identity. (Zděděno od ClaimsIdentity)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetObjectData(SerializationInfo, StreamingContext)	Naplní SerializationInfo data potřebná k serializaci aktuálního ClaimsIdentity objektu. (Zděděno od ClaimsIdentity)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
HasClaim(Predicate<Claim>)	Určuje, zda tato identita deklarací identity má deklaraci identity odpovídající zadanému predikátu. (Zděděno od ClaimsIdentity)
HasClaim(String, String)	Určuje, zda má tato identita deklarací identity se zadaným typem a hodnotou deklarace identity. (Zděděno od ClaimsIdentity)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
RemoveClaim(Claim)	Pokusí se odebrat deklaraci identity z identity deklarací identity. (Zděděno od ClaimsIdentity)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
TryRemoveClaim(Claim)	Pokusí se odebrat deklaraci identity z identity deklarací identity. (Zděděno od ClaimsIdentity)
WriteTo(BinaryWriter)	Serializuje pomocí .BinaryWriter (Zděděno od ClaimsIdentity)
WriteTo(BinaryWriter, Byte[])	Serializuje pomocí .BinaryWriter (Zděděno od ClaimsIdentity)

Platí pro

Viz také

Zprostředkovatel ověřování formulářů

Sdílet prostřednictvím