FormsAuthenticationEventArgs Classe

Définition

Espace de noms:

System.Web.Security

Assembly:

System.Web.dll

Fournit des données pour l’événement FormsAuthentication_OnAuthenticate. Cette classe ne peut pas être héritée.

public ref class FormsAuthenticationEventArgs sealed : EventArgs

public sealed class FormsAuthenticationEventArgs : EventArgs

type FormsAuthenticationEventArgs = class
    inherit EventArgs

Public NotInheritable Class FormsAuthenticationEventArgs
Inherits EventArgs

Héritage

Object

EventArgs

FormsAuthenticationEventArgs

Exemples

L’exemple de code suivant utilise l’événement FormsAuthentication_OnAuthenticate pour définir la User propriété du actif HttpContext sur un GenericPrincipal objet avec un personnalisé Identity.

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

La FormsAuthenticationEventArgs classe est utilisée pour fournir des valeurs d’événement à l’événement FormsAuthentication_OnAuthenticate et pour vous permettre de spécifier une identité personnalisée pour la requête actuelle.

Construit FormsAuthenticationModule un FormsAuthenticationEventArgs objet à l’aide du actif HttpContext et le transmet à l’événement FormsAuthentication_OnAuthenticate .

Vous pouvez utiliser la User propriété pour définir la User propriété du actif HttpContext sur un objet personnalisé IPrincipal .

Si vous ne spécifiez pas de valeur pour la User propriété pendant l’événement FormsAuthentication_OnAuthenticate , l’identité fournie par le ticket d’authentification par formulaire dans le cookie ou l’URL est utilisée.

L’événement FormsAuthentication_OnAuthenticate est déclenché uniquement lorsque l’authentification Mode est définie Forms sur et que le FormsAuthenticationModule est un module HTTP actif pour l’application.

Constructeurs

FormsAuthenticationEventArgs(HttpContext)

Initialise une nouvelle instance de la classe FormsAuthenticationEventArgs.

Propriétés

Context	Obtient l'objet HttpContext pour la requête HTTP actuelle.
User	Obtient ou définit l'objet IPrincipal à associer à la demande en cours.

Méthodes

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)
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)

Voir aussi

• Fournisseur d’authentification par formulaire