Partager via


FormsAuthenticationTicket Constructeurs

Définition

Initialise une nouvelle instance de la classe FormsAuthenticationTicket.

Surcharges

Nom Description
FormsAuthenticationTicket(String, Boolean, Int32)

Initialise une nouvelle instance de la classe à l’aide FormsAuthenticationTicket d’un nom de cookie et d’informations d’expiration.

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

Initialise une nouvelle instance de la FormsAuthenticationTicket classe avec un nom de cookie, une version, une date d’expiration, une date de problème, une persistance et des données spécifiques à l’utilisateur. Le chemin d’accès au cookie est défini sur la valeur par défaut établie dans le fichier de configuration de l’application.

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

Initialise une nouvelle instance de la FormsAuthenticationTicket classe avec un nom de cookie, une version, un chemin d’accès au répertoire, une date d’expiration, une date d’expiration, une persistance et des données définies par l’utilisateur.

FormsAuthenticationTicket(String, Boolean, Int32)

Initialise une nouvelle instance de la classe à l’aide FormsAuthenticationTicket d’un nom de cookie et d’informations d’expiration.

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ètres

name
String

Nom d’utilisateur associé au ticket.

isPersistent
Boolean

true si le ticket est stocké dans un cookie persistant (enregistré dans les sessions du navigateur) ; sinon, false. Si le ticket est stocké dans l’URL, cette valeur est ignorée.

timeout
Int32

Heure, en minutes, pendant laquelle le ticket d’authentification est valide.

Remarques

L’objet FormsAuthenticationTicket créé par ce constructeur aura une CookiePath valeur définie sur la valeur de la FormsCookiePath propriété, une Version valeur de 2, une IssueDate valeur de la date et de l’heure locales actuelles, une UserData valeur d’une chaîne vide («  »), et une Expiration valeur définie sur la date et l’heure locales actuelles, ainsi que la valeur du timeout paramètre.

Voir aussi

S’applique à

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

Initialise une nouvelle instance de la FormsAuthenticationTicket classe avec un nom de cookie, une version, une date d’expiration, une date de problème, une persistance et des données spécifiques à l’utilisateur. Le chemin d’accès au cookie est défini sur la valeur par défaut établie dans le fichier de configuration de l’application.

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ètres

version
Int32

Numéro de version du ticket.

name
String

Nom d’utilisateur associé au ticket.

issueDate
DateTime

Date et heure locales auxquelles le ticket a été émis.

expiration
DateTime

Date et heure locales à laquelle le ticket expire.

isPersistent
Boolean

true si le ticket est stocké dans un cookie persistant (enregistré dans les sessions du navigateur) ; sinon, false. Si le ticket est stocké dans l’URL, cette valeur est ignorée.

userData
String

Données spécifiques à l’utilisateur à stocker avec le ticket.

Remarques

L’objet FormsAuthenticationTicket créé par ce constructeur aura une CookiePath valeur définie sur la valeur du FormsCookiePath.

Note

Le userData paramètre ne peut pas être null.

Voir aussi

S’applique à

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

Initialise une nouvelle instance de la FormsAuthenticationTicket classe avec un nom de cookie, une version, un chemin d’accès au répertoire, une date d’expiration, une date d’expiration, une persistance et des données définies par l’utilisateur.

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ètres

version
Int32

Numéro de version du ticket.

name
String

Nom d’utilisateur associé au ticket.

issueDate
DateTime

Date et heure locales auxquelles le ticket a été émis.

expiration
DateTime

Date et heure locales à laquelle le ticket expire.

isPersistent
Boolean

true si le ticket est stocké dans un cookie persistant (enregistré dans les sessions du navigateur) ; sinon, false. Si le ticket est stocké dans l’URL, cette valeur est ignorée.

userData
String

Données spécifiques à l’utilisateur à stocker avec le ticket.

cookiePath
String

Chemin d’accès du ticket lorsqu’il est stocké dans un cookie.

Exemples

L’exemple de code suivant stocke le résultat de la Encrypt méthode dans un cookie à l’aide de la FormsCookieName propriété et redirige l’utilisateur vers l’URL retournée par la GetRedirectUrl méthode.

Important

Cet exemple contient une zone de texte qui accepte l’entrée utilisateur, qui est une menace de sécurité potentielle. Par défaut, ASP.NET pages web valident que l’entrée utilisateur n’inclut pas de script ou d’éléments HTML. Pour plus d’informations, consultez Vue d’ensemble des exploits de script.

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

Remarques

Note

Le userData paramètre ne peut pas être null.

Voir aussi

S’applique à