WindowsAuthenticationModule.Authenticate Événement
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Se produit lorsque l'application authentifie la demande actuelle.
public:
event System::Web::Security::WindowsAuthenticationEventHandler ^ Authenticate;public event System.Web.Security.WindowsAuthenticationEventHandler Authenticate;member this.Authenticate : System.Web.Security.WindowsAuthenticationEventHandler Public Custom Event Authenticate As WindowsAuthenticationEventHandler Type d'événement
Exemples
L’exemple de code suivant utilise l’événement WindowsAuthentication_OnAuthenticate pour définir la User propriété du actif HttpContext sur un objet personnalisé IPrincipal .
public void WindowsAuthentication_OnAuthenticate(object sender, WindowsAuthenticationEventArgs args)
{
if (!args.Identity.IsAnonymous)
{
args.User = new Samples.AspNet.Security.MyPrincipal(args.Identity);
}
}
Public Sub WindowsAuthentication_OnAuthenticate(sender As Object, args As WindowsAuthenticationEventArgs)
If Not args.Identity.IsAnonymous Then
args.User = New Samples.AspNet.Security.MyPrincipal(args.Identity)
End If
End Sub
Remarques
L’événement Authenticate est déclenché pendant l’événement AuthenticateRequest .
Vous pouvez accéder à l’événement Authenticate de la WindowsAuthenticationModule classe en spécifiant une sous-routine nommée WindowsAuthentication_OnAuthenticate dans le fichier Global.asax de votre application ASP.NET.
Vous pouvez utiliser la User propriété de l’objet WindowsAuthenticationEventArgs fourni à l’événement WindowsAuthentication_OnAuthenticate pour définir la User propriété du actuel HttpContext sur un objet personnalisé IPrincipal . Si vous ne spécifiez pas de valeur pour la User propriété pendant l’événement WindowsAuthentication_OnAuthenticate , l’identité Windows fournie par IIS est utilisée comme identité pour la requête actuelle. Si IIS utilise l’authentification anonyme, la Identity propriété est définie sur l’identité retournée par la GetAnonymous méthode .
L’événement WindowsAuthentication_OnAuthenticate est déclenché uniquement lorsque l’authentification Mode est définie Windows sur et que est WindowsAuthenticationModule un module HTTP actif pour l’application.
Notes
Dans IIS 7.0 exécuté en mode intégré, l’événement Authenticate de n’est WindowsAuthenticationModule pas déclenché lorsque les modules ASP.NET WindowsAuthenticationModule et IIS AnonymousAuthenticationModule sont activés. Dans ce scénario, pour recevoir une notification d’authentification, abonnez-vous à l’événement AuthenticateRequest de l’instance HttpApplication . 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.
