Condividi tramite

FormsAuthenticationModule Classe

Definizione

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

Imposta l'identità dell'utente per un'applicazione ASP.NET quando è abilitata l'autenticazione basata su form. Questa 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 utilizzato 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 Element (ASP.NET Settings Schema) del file di configurazione dell'applicazione.

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

Annotazioni

In IIS 7.0 l'uso di WindowsAuthenticationModule con FormsAuthenticationModule 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

Nome Descrizione
FormsAuthenticationModule()

Inizializza una nuova istanza della classe FormsAuthenticationModule.

Metodi

Nome Descrizione
Dispose()

Rilascia tutte le risorse, diverse dalla memoria, usate 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 il Type dell'istanza corrente.

(Ereditato da Object)
Init(HttpApplication)

Inizializza l'oggetto FormsAuthenticationModule.
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Eventi

Nome Descrizione
Authenticate

Si verifica quando l'applicazione autentica la richiesta corrente.

Si applica a

Vedi anche