FormsAuthenticationTicket Konstruktorok

Definíció

Névtér:: System.Web.Security

Szerelvény:: System.Web.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Inicializálja a FormsAuthenticationTicket osztály új példányát.

Túlterhelések

Name	Description
FormsAuthenticationTicket(String, Boolean, Int32)	Inicializálja az FormsAuthenticationTicket osztály új példányát egy cookie-név és a lejárati adatok használatával.
FormsAuthenticationTicket(Int32, String, DateTime, DateTime, Boolean, String)	Inicializálja az FormsAuthenticationTicket osztály új példányát a cookie nevével, verziójával, lejárati dátumával, kiadási dátumával, megőrzésével és felhasználóspecifikus adataival. A cookie elérési útja az alkalmazás konfigurációs fájljában létrehozott alapértelmezett értékre van állítva.
FormsAuthenticationTicket(Int32, String, DateTime, DateTime, Boolean, String, String)	Inicializálja az FormsAuthenticationTicket osztály új példányát a cookie nevével, verziójával, könyvtár elérési útjával, kiadási dátumával, lejárati dátumával, megőrzésével és felhasználó által megadott adatokkal.

FormsAuthenticationTicket(String, Boolean, Int32)

Inicializálja az FormsAuthenticationTicket osztály új példányát egy cookie-név és a lejárati adatok használatával.

public:
 FormsAuthenticationTicket(System::String ^ name, bool isPersistent, int timeout);

public FormsAuthenticationTicket(string name, bool isPersistent, int timeout);

new System.Web.Security.FormsAuthenticationTicket : string * bool * int -> System.Web.Security.FormsAuthenticationTicket

Public Sub New (name As String, isPersistent As Boolean, timeout As Integer)

Paraméterek

name: String

A jegyhez társított felhasználónév.

isPersistent: Boolean

trueha a jegy egy állandó cookie-ban lesz tárolva (böngésző-munkamenetek között mentve); egyéb esetben. false Ha a jegy az URL-címben van tárolva, a rendszer figyelmen kívül hagyja ezt az értéket.

timeout: Int32

Az az idő percben, amelyre a hitelesítési jegy érvényes.

Megjegyzések

A FormsAuthenticationTicket konstruktor CookiePath által létrehozott objektum értéke a FormsCookiePath tulajdonság értéke, a 2 érték, Version IssueDate az aktuális helyi dátum és idő értéke, UserData egy üres sztring ("") értéke, valamint az Expiration aktuális helyi dátumra és időre és a timeout paraméter értékére van beállítva.

Lásd még

Űrlaphitelesítési szolgáltató

A következőre érvényes:

FormsAuthenticationTicket(Int32, String, DateTime, DateTime, Boolean, String)

Inicializálja az FormsAuthenticationTicket osztály új példányát a cookie nevével, verziójával, lejárati dátumával, kiadási dátumával, megőrzésével és felhasználóspecifikus adataival. A cookie elérési útja az alkalmazás konfigurációs fájljában létrehozott alapértelmezett értékre van állítva.

public:
 FormsAuthenticationTicket(int version, System::String ^ name, DateTime issueDate, DateTime expiration, bool isPersistent, System::String ^ userData);

public FormsAuthenticationTicket(int version, string name, DateTime issueDate, DateTime expiration, bool isPersistent, string userData);

new System.Web.Security.FormsAuthenticationTicket : int * string * DateTime * DateTime * bool * string -> System.Web.Security.FormsAuthenticationTicket

Public Sub New (version As Integer, name As String, issueDate As DateTime, expiration As DateTime, isPersistent As Boolean, userData As String)

Paraméterek

version: Int32

A jegy verziószáma.

name: String

A jegyhez társított felhasználónév.

issueDate: DateTime

A jegy kiállításának helyi dátuma és időpontja.

expiration: DateTime

A jegy lejáratának helyi dátuma és időpontja.

isPersistent: Boolean

userData: String

A jegyben tárolandó felhasználóspecifikus adatok.

Megjegyzések

A FormsAuthenticationTicket konstruktor CookiePath által létrehozott objektum értéke a FormsCookiePath.

Note

A userData paraméter nem lehet null.

Lásd még

Űrlaphitelesítési szolgáltató

A következőre érvényes:

FormsAuthenticationTicket(Int32, String, DateTime, DateTime, Boolean, String, String)

Inicializálja az FormsAuthenticationTicket osztály új példányát a cookie nevével, verziójával, könyvtár elérési útjával, kiadási dátumával, lejárati dátumával, megőrzésével és felhasználó által megadott adatokkal.

public:
 FormsAuthenticationTicket(int version, System::String ^ name, DateTime issueDate, DateTime expiration, bool isPersistent, System::String ^ userData, System::String ^ cookiePath);

public FormsAuthenticationTicket(int version, string name, DateTime issueDate, DateTime expiration, bool isPersistent, string userData, string cookiePath);

new System.Web.Security.FormsAuthenticationTicket : int * string * DateTime * DateTime * bool * string * string -> System.Web.Security.FormsAuthenticationTicket

Public Sub New (version As Integer, name As String, issueDate As DateTime, expiration As DateTime, isPersistent As Boolean, userData As String, cookiePath As String)

Paraméterek

version: Int32

A jegy verziószáma.

name: String

A jegyhez társított felhasználónév.

issueDate: DateTime

A jegy kiállításának helyi dátuma és időpontja.

expiration: DateTime

A jegy lejáratának helyi dátuma és időpontja.

isPersistent: Boolean

userData: String

A jegyben tárolandó felhasználóspecifikus adatok.

cookiePath: String

A jegy elérési útja cookie-ban tárolva.

Példák

Az alábbi példakód egy cookie-ban tárolja a Encrypt metódus eredményét a FormsCookieName tulajdonság használatával, és átirányítja a felhasználót a metódusból GetRedirectUrl visszaadott URL-címre.

Important

Ez a példa egy szövegdobozt tartalmaz, amely elfogadja a felhasználói bemenetet, ami potenciális biztonsági fenyegetés. Alapértelmezés szerint ASP.NET weblapok ellenőrzik, hogy a felhasználói bevitel nem tartalmaz-e szkript- vagy HTML-elemeket. További információ: Szkript kihasználása – áttekintés.

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

<%@ Page Language="VB" %>
<%@ 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 Sub Login_Click(sender As Object, e As EventArgs)
  
    ' Create a custom FormsAuthenticationTicket containing
    ' application specific data for the user.

        Dim username As String = UserNameTextBox.Text
        Dim password As String = UserPassTextBox.Text
        Dim isPersistent As Boolean = False

    If Membership.ValidateUser(username, password) Then
    
      Dim userData As String = "ApplicationSpecific data for this user."

      Dim ticket As FormsAuthenticationTicket = New FormsAuthenticationTicket(1, _
        username, _
        DateTime.Now, _
        DateTime.Now.AddMinutes(30), _
        isPersistent, _
        userData, _
        FormsAuthentication.FormsCookiePath)

      ' Encrypt the ticket.
      Dim encTicket As String = 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."
    End If
  End Sub

</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>

Megjegyzések

Note

A userData paraméter nem lehet null.

Lásd még

Űrlaphitelesítési szolgáltató

A következőre érvényes:

Visszajelzés

Hasznosnak találta ezt az oldalt?