FormsAuthenticationModule Classe

Définition

Espace de noms:

System.Web.Security

Assembly:

System.Web.dll

Définit l'identité de l'utilisateur pour une application ASP.NET lorsque l'authentification par formulaire est activée. Cette classe ne peut pas être héritée.

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

Héritage

Object

FormsAuthenticationModule

Implémente

IHttpModule

Exemples

L’exemple suivant utilise l’événement FormsAuthentication_OnAuthenticate pour définir la User propriété du actif HttpContext sur un objet personnalisé 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

Remarques

Définit FormsAuthenticationModule la propriété actuelle HttpContext.User sur un IPrincipal objet qui représente l’identité de l’utilisateur pour la requête actuelle lorsque l’authentification Mode est définie Forms sur dans l’élément authentication Element (ASP.NET Settings Schema) du fichier de configuration de l’application.

expose FormsAuthenticationModule un Authenticate événement qui vous permet de fournir un objet personnalisé IPrincipal pour la User propriété du actuel HttpContext. L’événement Authenticate est accessible en spécifiant une sous-routine nommée FormsAuthentication_OnAuthenticate dans le fichier Global.asax de votre application ASP.NET.

Notes

Dans IIS 7.0, l’utilisation de WindowsAuthenticationModule avec n’est FormsAuthenticationModule pas prise en charge. Pour plus d’informations sur les problèmes de compatibilité dans les modes intégrés, consultez Déplacement d’une application ASP.NET d’IIS 6.0 vers IIS 7.0.

Constructeurs

FormsAuthenticationModule()

Initialise une nouvelle instance de la classe FormsAuthenticationModule.

Méthodes

Dispose()	Libère toutes les ressources (autres que la mémoire) utilisées par FormsAuthenticationModule.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
Init(HttpApplication)	Initialise l'objet FormsAuthenticationModule.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Événements

Authenticate

Se produit lorsque l'application authentifie la demande actuelle.

Voir aussi

• Fournisseur d’authentification par formulaire