FormsAuthenticationModule Classe

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.Security
Assembly:
System.Web.dll

Imposta l'identità dell'utente per un'applicazione ASP.NET quando viene attivata l'autenticazione dei form. La classe non può essere ereditata.

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
Ereditarietà
Object
FormsAuthenticationModule
Implementazioni
IHttpModule

Esempio

Nell'esempio seguente viene usato l'evento FormsAuthentication_OnAuthenticate per impostare la User proprietà dell'oggetto corrente HttpContext su un oggetto personalizzato 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

Commenti

Imposta FormsAuthenticationModule la proprietà corrente HttpContext.User su un IPrincipal oggetto che rappresenta l'identità utente per la richiesta corrente quando l'autenticazione Mode è impostata su Forms nell'elemento authentication (ASP.NET Settings Schema) del file di configurazione dell'applicazione.

Espone FormsAuthenticationModule un Authenticate evento che consente di fornire un oggetto personalizzato IPrincipal per la proprietà dell'oggetto User corrente HttpContext. L'evento Authenticate viene accessibile specificando una subroutine denominata FormsAuthentication_OnAuthenticate nel file Global.asax per l'applicazione ASP.NET.

Nota

In IIS 7.0 l'uso con l'oggetto WindowsAuthenticationModuleFormsAuthenticationModule non è supportato. Per altre informazioni sui problemi di compatibilità nelle modalità integrate, vedere Spostamento di un'applicazione ASP.NET da IIS 6.0 a IIS 7.0.

Costruttori

FormsAuthenticationModule()

Inizializza una nuova istanza della classe FormsAuthenticationModule.

Metodi

Dispose()

Rilascia tutte le risorse, diverse dalla memoria, utilizzate da FormsAuthenticationModule.
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
Init(HttpApplication)

Inizializza l'oggetto FormsAuthenticationModule.
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Eventi

Authenticate

Si verifica quando la richiesta corrente viene autenticata dall'applicazione.

Si applica a

Vedi anche