CreatingCookieEventArgs Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona datos para el evento CreatingCookie.
public ref class CreatingCookieEventArgs : EventArgs
public class CreatingCookieEventArgs : EventArgs
type CreatingCookieEventArgs = class
inherit EventArgs
Public Class CreatingCookieEventArgs
Inherits EventArgs
- Herencia
Ejemplos
En el ejemplo siguiente se muestra un controlador de eventos para el CreatingCookie evento. El controlador recupera los valores de usuario del CreatingCookieEventArgs objeto para personalizar la cookie de autenticación. El controlador guarda el valor de la propiedad en el CustomCredential vale de autenticación y establece la CookieIsSet propiedad en true
para indicar que se ha creado la cookie de autenticación.
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
Comentarios
La CreatingCookieEventArgs clase proporciona valores a cualquier CreatingCookie controlador de eventos. Con las propiedades de esta clase, puede recuperar las credenciales de usuario al crear una cookie de autenticación personalizada.
La AuthenticationService clase genera el CreatingCookie evento cuando establece la cookie de autenticación, una vez autenticadas las credenciales de usuario. La AuthenticationService clase construye un CreatingCookieEventArgs objeto y lo pasa a cualquier CreatingCookie controlador de eventos.
Las credenciales de usuario se recuperan a través de las UserNamePasswordpropiedades , y CustomCredential . La CustomCredential propiedad puede contener cualquier valor personalizado que necesite para autenticarse, como un número de identificación. La IsPersistent propiedad indica si la cookie de autenticación debe conservarse más allá de la sesión actual. Establezca la CookieIsSet propiedad true
en si crea la cookie de autenticación para que la AuthenticationService clase no cree la cookie.
Propiedades
CookieIsSet |
Obtiene o establece un valor que indica si se ha creado la cookie de autenticación. |
CustomCredential |
Obtiene los valores de autenticación adicionales proporcionados por el usuario. |
IsPersistent |
Obtiene un valor que indica si la cookie de autenticación se debería retener después de la sesión actual. |
Password |
Obtiene la contraseña del usuario. |
UserName |
Obtiene el nombre del usuario. |
Métodos
Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |