Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original. |
Traducción
Original
|
FormsAuthenticationEventArgs (Clase)
Proporciona datos para el evento FormsAuthentication_OnAuthenticate. Esta clase no puede heredarse.
Ensamblado: System.Web (en System.Web.dll)
El tipo FormsAuthenticationEventArgs expone los siguientes miembros.
| Nombre | Descripción | |
|---|---|---|
|
FormsAuthenticationEventArgs | Inicializa una nueva instancia de la clase FormsAuthenticationEventArgs. |
| Nombre | Descripción | |
|---|---|---|
|
Context | Obtiene el objeto HttpContext de la solicitud HTTP actual. |
|
|
User | Obtiene y establece el objeto IPrincipal que se va a asociar a la solicitud actual. |
| Nombre | Descripción | |
|---|---|---|
|
|
Equals(Object) | Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object). |
|
Finalize | Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object). |
|
|
GetHashCode | Actúa como función hash para un tipo concreto. (Se hereda de Object). |
|
|
GetType | Obtiene el objeto Type de la instancia actual. (Se hereda de Object). |
|
|
MemberwiseClone | Crea una copia superficial del objeto Object actual. (Se hereda de Object). |
|
|
ToString | Devuelve una cadena que representa el objeto actual. (Se hereda de Object). |
La clase FormsAuthenticationEventArgs se utiliza para proporcionar valores de evento al evento FormsAuthentication_OnAuthenticate y permitirle especificar una identidad personalizada para la solicitud actual.
El objeto FormsAuthenticationModule crea un objeto FormsAuthenticationEventArgs utilizando la instancia de HttpContext actual y se lo pasa al evento FormsAuthentication_OnAuthenticate.
Puede utilizar la propiedad User para establecer la propiedad User del objeto HttpContext actual en un objeto IPrincipal personalizado.
Si no se especifica un valor para la propiedad User durante el evento FormsAuthentication_OnAuthenticate, se utiliza la identidad proporcionada por el vale de autenticación de formularios en la cookie o en la dirección URL.
El evento FormsAuthentication_OnAuthenticate sólo se provoca cuando la propiedad Mode de autenticación se establece en Forms y FormsAuthenticationModule es un módulo HTTP activo de la aplicación.
En el ejemplo de código siguiente se utiliza el evento FormsAuthentication_OnAuthenticate para establecer la propiedad User del objeto HttpContext actual en un objeto GenericPrincipal con una identidad Identity personalizada.
public void FormsAuthentication_OnAuthenticate(object sender, FormsAuthenticationEventArgs args) { if (FormsAuthentication.CookiesSupported) { if (Request.Cookies[FormsAuthentication.FormsCookieName] != null) { try { FormsAuthenticationTicket ticket = FormsAuthentication.Decrypt( Request.Cookies[FormsAuthentication.FormsCookieName].Value); args.User = new System.Security.Principal.GenericPrincipal( new Samples.AspNet.Security.MyFormsIdentity(ticket), new string[0]); } catch (Exception e) { // Decrypt method failed. } } } else { throw new HttpException("Cookieless Forms Authentication is not " + "supported for this application."); } }
Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2
.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
