FormsAuthenticationModule Classe

Définition

Définit l'identité de l'utilisateur pour une application ASP.NET lorsque l'authentification par formulaire est activée.Sets the identity of the user for an ASP.NET application when forms authentication is enabled. Cette classe ne peut pas être héritée.This class cannot be inherited.

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
FormsAuthenticationModule
Implémente

Exemples

L’exemple suivant utilise l’événement FormsAuthentication_OnAuthenticate pour affecter User à la propriété du actuel la valeur d' HttpContext un IPrincipal objet personnalisé.The following example uses the FormsAuthentication_OnAuthenticate event to set the User property of the current HttpContext to a custom IPrincipal object.

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

FormsAuthenticationModuleDéfinit 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 a la valeur Forms dans l’élément authentication (schéma des paramètres ASP.net) du fichier de configuration de l’application.The FormsAuthenticationModule sets the current HttpContext.User property to an IPrincipal object that represents the user identity for the current request when the authentication Mode is set to Forms in the authentication Element (ASP.NET Settings Schema) element of the application's configuration file.

FormsAuthenticationModuleExpose un Authenticate événement qui vous permet de fournir un objet personnalisé IPrincipal pour la User propriété du actuel HttpContext .The FormsAuthenticationModule exposes an Authenticate event that enables you to provide a custom IPrincipal object for the User property of the current HttpContext. L' Authenticate événement est accessible en spécifiant une sous-routine nommée FormsAuthentication_OnAuthenticate dans le fichier global. asax de votre application ASP.net.The Authenticate event is accessed by specifying a subroutine named FormsAuthentication_OnAuthenticate in the Global.asax file for your ASP.NET application.

Notes

Dans IIS 7,0, l’utilisation de WindowsAuthenticationModule avec le FormsAuthenticationModule n’est pas prise en charge.In IIS 7.0, using the WindowsAuthenticationModule with the FormsAuthenticationModule is not supported. 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.For more information about compatibility issues in Integrated modes, see Moving an ASP.NET Application from IIS 6.0 to IIS 7.0.

Constructeurs

FormsAuthenticationModule()

Initialise une nouvelle instance de la classe FormsAuthenticationModule.Initializes a new instance of the FormsAuthenticationModule class.

Méthodes

Dispose()

Libère toutes les ressources (autres que la mémoire) utilisées par FormsAuthenticationModule.Releases all resources, other than memory, used by the FormsAuthenticationModule.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
Init(HttpApplication)

Initialise l'objet FormsAuthenticationModule.Initializes the FormsAuthenticationModule object.

MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Hérité de Object)

Événements

Authenticate

Se produit lorsque l'application authentifie la demande actuelle.Occurs when the application authenticates the current request.

S’applique à

Voir aussi