CreatingCookieEventArgs Classe

Definição

Fornece dados para o CreatingCookie evento.

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 seguinte mostra um gestor de eventos para o CreatingCookie evento. O handler recupera valores de utilizador do CreatingCookieEventArgs objeto para personalizar o cookie de autenticação. O handler guarda o valor da CustomCredential propriedade no ticket de autenticação e define a CookieIsSet propriedade para true 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

Observações

A CreatingCookieEventArgs classe fornece valores a qualquer CreatingCookie gestor de eventos. Ao usar as propriedades desta classe, pode obter credenciais de utilizador ao criar um cookie de autenticação personalizado.

A AuthenticationService classe levanta o CreatingCookie evento quando define o cookie de autenticação, depois de as credenciais do utilizador terem sido autenticadas. A AuthenticationService classe constrói um CreatingCookieEventArgs objeto e passa-o a qualquer CreatingCookie gestor de eventos.

Recupera as credenciais de utilizador através das UserNamePasswordpropriedades , e CustomCredential . A CustomCredential propriedade pode conter quaisquer valores personalizados que precise de autenticar, como um número de identificação. A IsPersistent propriedade indica se o cookie de autenticação deve ser mantido para além da sessão atual. Defina a CookieIsSet propriedade para true se criar o cookie de autenticação, para que a AuthenticationService classe não crie o cookie.

Propriedades

Name Description
CookieIsSet

Recebe ou define um valor que indica se o cookie de autenticação foi criado.

CustomCredential

Obtém valores adicionais de autenticação fornecidos pelo utilizador.

IsPersistent

Recebe um valor que indica se o cookie de autenticação deve ser mantido para além da sessão atual.

Password

Obtém a palavra-passe do utilizador.

UserName

Obtém o nome do utilizador.

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Ver também