Esporta (0) Stampa
Espandi tutto
Il presente articolo è stato tradotto automaticamente. Passare il puntatore sulle frasi nell'articolo per visualizzare il testo originale. Ulteriori informazioni.
Traduzione
Originale

Classe FormsAuthenticationModule

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

System.Object
  System.Web.Security.FormsAuthenticationModule

Spazio dei nomi:  System.Web.Security
Assembly:  System.Web (in System.Web.dll)

public sealed class FormsAuthenticationModule : IHttpModule

Il tipo FormsAuthenticationModule espone i seguenti membri.

  NomeDescrizione
Metodo pubblicoFormsAuthenticationModuleInizializza una nuova istanza della classe FormsAuthenticationModule.
In alto

  NomeDescrizione
Metodo pubblicoDisposeConsente di liberare tutte le risorse, diverse dalla memoria, utilizzate da FormsAuthenticationModule.
Metodo pubblicoEquals(Object) Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
Metodo pubblicoGetHashCode Funge da funzione hash per un particolare tipo. (Ereditato da Object)
Metodo pubblicoGetType Ottiene il Type dell'istanza corrente. (Ereditato da Object)
Metodo pubblicoInitInizializza l'oggetto FormsAuthenticationModule.
Metodo pubblicoToString Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
In alto

  NomeDescrizione
Evento pubblicoAuthenticateSi verifica quando la richiesta corrente viene autenticata dall'applicazione.
In alto

L'oggetto FormsAuthenticationModule imposta la proprietà HttpContext.User corrente su un oggetto IPrincipal che rappresenta l'identità utente per la richiesta corrente quando la proprietà Mode di autenticazione viene impostata su Forms nell'elemento Elemento authentication (schema delle impostazioni ASP.NET) del file di configurazione dell'applicazione.

L'oggetto FormsAuthenticationModule espone un evento Authenticate che consente di fornire un oggetto IPrincipal personalizzato per la proprietà User del contesto HttpContext corrente. È possibile accedere all'evento Authenticate specificando una subroutine denominata FormsAuthentication_OnAuthenticate nel file Global.asax per l'applicazione ASP.NET.

NotaNota

In IIS 7.0 non è supportato l'utilizzo dell'oggetto WindowsAuthenticationModule con FormsAuthenticationModule. Per ulteriori informazioni sui problemi di compatibilità nelle modalità integrate, vedere Moving an ASP.NET Application from IIS 6.0 to IIS 7.0.

Nell'esempio riportato di seguito viene utilizzato l'evento FormsAuthentication_OnAuthenticate per impostare la proprietà User dell'oggetto HttpContext corrente su un oggetto IPrincipal personalizzato.


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.");
  }
}


.NET Framework

Supportato in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.

Aggiunte alla community

AGGIUNGI
Microsoft sta conducendo un sondaggio in linea per comprendere l'opinione degli utenti in merito al sito Web di MSDN. Se si sceglie di partecipare, quando si lascia il sito Web di MSDN verrà visualizzato il sondaggio in linea.

Si desidera partecipare?
Mostra:
© 2015 Microsoft