CreatingCookieEventArgs Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit des données pour l'événement CreatingCookie.
public ref class CreatingCookieEventArgs : EventArgs
public class CreatingCookieEventArgs : EventArgs
type CreatingCookieEventArgs = class
inherit EventArgs
Public Class CreatingCookieEventArgs
Inherits EventArgs
- Héritage
Exemples
L’exemple suivant montre un gestionnaire d’événements pour l’événement CreatingCookie . Le gestionnaire récupère les valeurs utilisateur de l’objet CreatingCookieEventArgs pour personnaliser le cookie d’authentification. Le gestionnaire enregistre la valeur de la propriété dans le CustomCredential ticket d’authentification et définit la CookieIsSet propriété sur true
pour indiquer que le cookie d’authentification a été créé.
void AuthenticationService_CreatingCookie(object sender,
System.Web.ApplicationServices.CreatingCookieEventArgs e)
{
FormsAuthenticationTicket ticket = new
FormsAuthenticationTicket
(1,
e.UserName,
DateTime.Now,
DateTime.Now.AddMinutes(30),
e.IsPersistent,
e.CustomCredential,
FormsAuthentication.FormsCookiePath);
string encryptedTicket =
FormsAuthentication.Encrypt(ticket);
HttpCookie cookie = new HttpCookie
(FormsAuthentication.FormsCookieName,
encryptedTicket);
cookie.Expires = DateTime.Now.AddMinutes(30);
HttpContext.Current.Response.Cookies.Add(cookie);
e.CookieIsSet = true;
}
Sub AuthenticationService_CreatingCookie(ByVal sender As Object, _
ByVal e As System.Web.ApplicationServices.CreatingCookieEventArgs)
Dim ticket As FormsAuthenticationTicket = New _
FormsAuthenticationTicket _
(1, _
e.Username, _
DateTime.Now, _
DateTime.Now.AddMinutes(30), _
e.IsPersistent, _
e.CustomCredential, _
FormsAuthentication.FormsCookiePath)
Dim encryptedTicket As String = FormsAuthentication.Encrypt(ticket)
Dim cookie As HttpCookie = New _
HttpCookie(FormsAuthentication.FormsCookieName, encryptedTicket)
cookie.Expires = DateTime.Now.AddMinutes(30)
HttpContext.Current.Response.Cookies.Add(cookie)
e.CookieIsSet = True
End Sub
Remarques
La CreatingCookieEventArgs classe fournit des valeurs à n’importe quel CreatingCookie gestionnaire d’événements. En utilisant les propriétés de cette classe, vous pouvez récupérer les informations d’identification de l’utilisateur lorsque vous créez un cookie d’authentification personnalisé.
La AuthenticationService classe déclenche l’événement CreatingCookie lorsqu’elle définit le cookie d’authentification, une fois que les informations d’identification de l’utilisateur ont été authentifiées. La AuthenticationService classe construit un CreatingCookieEventArgs objet et le transmet à n’importe quel CreatingCookie gestionnaire d’événements.
Vous récupérez les informations d’identification de l’utilisateur via les UserNamePasswordpropriétés et CustomCredential . La CustomCredential propriété peut contenir toutes les valeurs personnalisées dont vous avez besoin pour vous authentifier, comme un numéro d’identification. La IsPersistent propriété indique si le cookie d’authentification doit être conservé après la session active. Définissez la CookieIsSet propriété true
sur si vous créez le cookie d’authentification, afin que la AuthenticationService classe ne crée pas le cookie.
Propriétés
CookieIsSet |
Obtient ou définit une valeur qui indique si le cookie d'authentification a été créé. |
CustomCredential |
Obtient des valeurs d'authentification supplémentaires qui sont fournies par l'utilisateur. |
IsPersistent |
Obtient une valeur qui indique si le cookie d'authentification doit être conservé à l'issue de la session actuelle. |
Password |
Obtient le mot de passe de l'utilisateur. |
UserName |
Obtient le nom de l’utilisateur. |
Méthodes
Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |