CreatingCookieEventArgs Classe

Definição

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
CreatingCookieEventArgs

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)

Aplica-se a

Confira também