FormsAuthenticationModule Clase

Definición

Espacio de nombres:

System.Web.Security

Ensamblado:

System.Web.dll

Establece la identidad del usuario para una aplicación ASP.NET cuando se habilita la autenticación de formularios. Esta clase no puede heredarse.

public ref class FormsAuthenticationModule sealed : System::Web::IHttpModule

public sealed class FormsAuthenticationModule : System.Web.IHttpModule

type FormsAuthenticationModule = class
    interface IHttpModule

Public NotInheritable Class FormsAuthenticationModule
Implements IHttpModule

Herencia

Object

FormsAuthenticationModule

Implementaciones

IHttpModule

Ejemplos

En el ejemplo siguiente se usa el evento FormsAuthentication_OnAuthenticate para establecer la User propiedad del objeto actual HttpContext en un objeto personalizado IPrincipal .

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

FormsAuthenticationModule Establece la propiedad actual HttpContext.User en un IPrincipal objeto que representa la identidad del usuario para la solicitud actual cuando la autenticación Mode se establece Forms en en el elemento authentication Element (ASP.NET Settings Schema) del archivo de configuración de la aplicación.

FormsAuthenticationModule expone un Authenticate evento que permite proporcionar un objeto personalizado IPrincipal para la User propiedad del objeto actualHttpContext. Para Authenticate acceder al evento, se especifica una subrutina denominada FormsAuthentication_OnAuthenticate en el archivo Global.asax para la aplicación de ASP.NET.

Nota

En IIS 7.0, no se admite el uso WindowsAuthenticationModule de con .FormsAuthenticationModule Para obtener más información sobre los problemas de compatibilidad en modos integrados, consulte Traslado de una aplicación de ASP.NET de IIS 6.0 a IIS 7.0.

Constructores

FormsAuthenticationModule()

Inicializa una nueva instancia de la clase FormsAuthenticationModule.

Métodos

Dispose()	Libera todos los recursos usados por FormsAuthenticationModule, excepto la memoria.
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)
Init(HttpApplication)	Inicializa el objeto FormsAuthenticationModule.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Eventos

Authenticate

Tiene lugar cuando la aplicación autentica la solicitud actual.

Consulte también

• Proveedor de autenticación de formularios