FormsAuthenticationModule Clase

  • Referencia

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.

Se aplica a

Consulte también