Partager via

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 courant HttpContext sur un GenericPrincipal objet avec un objet 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 au FormsAuthentication_OnAuthenticate événement et pour vous permettre de spécifier une identité personnalisée pour la requête actuelle.

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

Vous pouvez utiliser la User propriété pour définir la User propriété actuelle 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 et qu’il FormsAuthenticationModule s’agit d’un module HTTP actif pour l’application.

Constructeurs

Nom Description
FormsAuthenticationEventArgs(HttpContext)

Initialise une nouvelle instance de la classe FormsAuthenticationEventArgs.

Propriétés

Nom Description
Context

Obtient l’objet HttpContext de la requête HTTP actuelle.
User

Obtient ou définit l’objet IPrincipal à associer à la requête actuelle.

Méthodes

Nom Description
Equals(Object)

Détermine si l’objet spécifié est égal à l’objet actuel.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l’objet actuel.

(Hérité de Object)

S’applique à

Voir aussi