CreatingCookieEventArgs Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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
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) |