FormsAuthenticationEventHandler Delegado
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í.
Representa el método que controla el evento FormsAuthentication_OnAuthenticate de un FormsAuthenticationModule.
public delegate void FormsAuthenticationEventHandler(System::Object ^ sender, FormsAuthenticationEventArgs ^ e);
public delegate void FormsAuthenticationEventHandler(object sender, FormsAuthenticationEventArgs e);
type FormsAuthenticationEventHandler = delegate of obj * FormsAuthenticationEventArgs -> unit
Public Delegate Sub FormsAuthenticationEventHandler(sender As Object, e As FormsAuthenticationEventArgs)
Parámetros
- sender
- Object
Origen del evento.
Objeto FormsAuthenticationEventArgs que contiene los datos del evento.
Ejemplos
En el ejemplo de código siguiente se usa el evento FormsAuthentication_OnAuthenticate para establecer la User propiedad del objeto actual HttpContext en un GenericPrincipal objeto con un personalizado Identity.
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.");
}
}
Public Sub FormsAuthentication_OnAuthenticate(sender As Object, _
args As FormsAuthenticationEventArgs)
If FormsAuthentication.CookiesSupported Then
If Not Request.Cookies(FormsAuthentication.FormsCookieName) Is Nothing Then
Try
Dim ticket As FormsAuthenticationTicket = FormsAuthentication.Decrypt( _
Request.Cookies(FormsAuthentication.FormsCookieName).Value)
args.User = New System.Security.Principal.GenericPrincipal( _
New Samples.AspNet.Security.MyFormsIdentity(ticket), _
New String(0) {})
Catch e As HttpException
' Decrypt method failed.
End Try
End If
Else
Throw New Exception("Cookieless Forms Authentication is not " & _
"supported for this application.")
End If
End Sub
Comentarios
El FormsAuthenticationEventHandler delegado se define para el Authenticate evento de la FormsAuthenticationModule clase . Puede acceder al Authenticate evento de la FormsAuthenticationModule clase especificando una subrutina denominada FormsAuthentication_OnAuthenticate en el archivo Global.asax de la aplicación ASP.NET. El Authenticate evento se genera durante el AuthenticateRequest evento .
FormsAuthenticationModule Construye un FormsAuthenticationEventArgs objeto con el objeto actual HttpContext y lo pasa al evento FormsAuthentication_OnAuthenticate.
Puede usar la User propiedad del FormsAuthenticationEventArgs objeto proporcionado al evento FormsAuthentication_OnAuthenticate para establecer la User propiedad del objeto actual HttpContext en un objeto personalizado IPrincipal . Si no especifica un valor para la User propiedad durante el evento de FormsAuthentication_OnAuthenticate , se usa la identidad proporcionada por el vale de autenticación de formularios en la cookie o la dirección URL.
El evento FormsAuthentication_OnAuthenticate solo se genera cuando la autenticación Mode se establece Forms en y FormsAuthenticationModule es un módulo HTTP activo para la aplicación.
Métodos de extensión
GetMethodInfo(Delegate) |
Obtiene un objeto que representa el método representado por el delegado especificado. |