FormsAuthenticationTicket Constructors

Definitie

Naamruimte:: System.Web.Security

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Initialiseert een nieuw exemplaar van de FormsAuthenticationTicket klasse.

Overloads

Name	Description
FormsAuthenticationTicket(String, Boolean, Int32)	Initialiseert een nieuw exemplaar van de FormsAuthenticationTicket klasse met behulp van een cookienaam en verloopgegevens.
FormsAuthenticationTicket(Int32, String, DateTime, DateTime, Boolean, String)	Initialiseert een nieuw exemplaar van de FormsAuthenticationTicket klasse met cookienaam, versie, vervaldatum, uitgiftedatum, persistentie en gebruikersspecifieke gegevens. Het cookiepad wordt ingesteld op de standaardwaarde die is ingesteld in het configuratiebestand van de toepassing.
FormsAuthenticationTicket(Int32, String, DateTime, DateTime, Boolean, String, String)	Initialiseert een nieuw exemplaar van de FormsAuthenticationTicket klasse met cookienaam, versie, mappad, uitgiftedatum, vervaldatum, persistentie en door de gebruiker gedefinieerde gegevens.

FormsAuthenticationTicket(String, Boolean, Int32)

Initialiseert een nieuw exemplaar van de FormsAuthenticationTicket klasse met behulp van een cookienaam en verloopgegevens.

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)

Parameters

name: String

De gebruikersnaam die aan het ticket is gekoppeld.

isPersistent: Boolean

true als het ticket wordt opgeslagen in een permanente cookie (opgeslagen in browsersessies); anders, false. Als het ticket is opgeslagen in de URL, wordt deze waarde genegeerd.

timeout: Int32

De tijd, in minuten, waarvoor het verificatieticket geldig is.

Opmerkingen

Het FormsAuthenticationTicket object dat door deze constructor is gemaakt, heeft een CookiePath waarde die is ingesteld op de waarde van de FormsCookiePath eigenschap, een Version waarde van 2, een IssueDate waarde van de huidige lokale datum en tijd, een UserData waarde van een lege tekenreeks ("") en een Expiration waarde die is ingesteld op de huidige lokale datum en tijd plus de waarde van de timeout parameter.

Zie ook

Formulierverificatieprovider

Van toepassing op

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

Initialiseert een nieuw exemplaar van de FormsAuthenticationTicket klasse met cookienaam, versie, vervaldatum, uitgiftedatum, persistentie en gebruikersspecifieke gegevens. Het cookiepad wordt ingesteld op de standaardwaarde die is ingesteld in het configuratiebestand van de toepassing.

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)

Parameters

version: Int32

Het versienummer van het ticket.

name: String

De gebruikersnaam die aan het ticket is gekoppeld.

issueDate: DateTime

De lokale datum en tijd waarop het ticket is uitgegeven.

expiration: DateTime

De lokale datum en tijd waarop het ticket verloopt.

isPersistent: Boolean

true als het ticket wordt opgeslagen in een permanente cookie (opgeslagen in browsersessies); anders, false. Als het ticket is opgeslagen in de URL, wordt deze waarde genegeerd.

userData: String

De gebruikersspecifieke gegevens die met het ticket moeten worden opgeslagen.

Opmerkingen

Het FormsAuthenticationTicket object dat door deze constructor is gemaakt, heeft een CookiePath waarde ingesteld op de waarde van de FormsCookiePath.

Note

De userData parameter kan niet zijn null.

Zie ook

Formulierverificatieprovider

Van toepassing op

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

Initialiseert een nieuw exemplaar van de FormsAuthenticationTicket klasse met cookienaam, versie, mappad, uitgiftedatum, vervaldatum, persistentie en door de gebruiker gedefinieerde gegevens.

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)

Parameters

version: Int32

Het versienummer van het ticket.

name: String

De gebruikersnaam die aan het ticket is gekoppeld.

issueDate: DateTime

De lokale datum en tijd waarop het ticket is uitgegeven.

expiration: DateTime

De lokale datum en tijd waarop het ticket verloopt.

isPersistent: Boolean

true als het ticket wordt opgeslagen in een permanente cookie (opgeslagen in browsersessies); anders, false. Als het ticket is opgeslagen in de URL, wordt deze waarde genegeerd.

userData: String

De gebruikersspecifieke gegevens die met het ticket moeten worden opgeslagen.

cookiePath: String

Het pad voor het ticket wanneer het is opgeslagen in een cookie.

Voorbeelden

In het volgende codevoorbeeld wordt het resultaat van de Encrypt methode opgeslagen in een cookie met behulp van de FormsCookieName eigenschap en wordt de gebruiker omgeleid naar de URL die door de GetRedirectUrl methode wordt geretourneerd.

Important

Dit voorbeeld bevat een tekstvak dat gebruikersinvoer accepteert. Dit is een mogelijke beveiligingsrisico. Standaard valideren ASP.NET webpagina's dat gebruikersinvoer geen script- of HTML-elementen bevat. Zie Overzicht van Script Exploits voor meer informatie.

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

Opmerkingen

Note

De userData parameter kan niet zijn null.

Zie ook

Formulierverificatieprovider

Van toepassing op

Feedback

Is deze pagina nuttig?