CreatingCookieEventArgs Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece dados para o evento de CreatingCookie .
public ref class CreatingCookieEventArgs : EventArgs
public class CreatingCookieEventArgs : EventArgs
type CreatingCookieEventArgs = class
inherit EventArgs
Public Class CreatingCookieEventArgs
Inherits EventArgs
- Herança
Exemplos
O exemplo a seguir mostra um manipulador de eventos para o CreatingCookie evento. O manipulador recupera valores de usuário do CreatingCookieEventArgs objeto para personalizar o cookie de autenticação. O manipulador salva o valor da propriedade no tíquete de CustomCredential autenticação e define a CookieIsSet propriedade como true
para indicar que o cookie de autenticação foi criado.
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
Comentários
A CreatingCookieEventArgs classe fornece valores para qualquer CreatingCookie manipulador de eventos. Usando as propriedades dessa classe, você pode recuperar credenciais de usuário ao criar um cookie de autenticação personalizado.
A AuthenticationService classe aciona o CreatingCookie evento quando define o cookie de autenticação, depois que as credenciais do usuário são autenticadas. A AuthenticationService classe constrói um CreatingCookieEventArgs objeto e o passa para qualquer CreatingCookie manipulador de eventos.
Você recupera as credenciais do usuário por meio das UserNamePasswordpropriedades e CustomCredential . A CustomCredential propriedade pode conter todos os valores personalizados necessários para autenticar, como um número de identificação. A IsPersistent propriedade indica se o cookie de autenticação deve ser retido após a sessão atual. Defina a CookieIsSet propriedade true
como se você criar o cookie de autenticação, para que a AuthenticationService classe não crie o cookie.
Propriedades
CookieIsSet |
Obtém ou define um valor que indica se o cookie de autenticação foi criado. |
CustomCredential |
Obtém valores de autenticação adicionais que são fornecidos pelo usuário. |
IsPersistent |
Obtém um valor que indica se o cookie de autenticação deve ser retido além da sessão atual. |
Password |
Obtém a senha do usuário. |
UserName |
Obtém o nome do usuário. |
Métodos
Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |