WindowsAuthenticationModule.Authenticate-Ereignis
Tritt ein, wenn die Anwendung die aktuelle Anforderung authentifiziert.
Namespace: System.Web.Security
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Public Event Authenticate As WindowsAuthenticationEventHandler
'Usage
Dim instance As WindowsAuthenticationModule
Dim handler As WindowsAuthenticationEventHandler
AddHandler instance.Authenticate, handler
public event WindowsAuthenticationEventHandler Authenticate
public:
event WindowsAuthenticationEventHandler^ Authenticate {
void add (WindowsAuthenticationEventHandler^ value);
void remove (WindowsAuthenticationEventHandler^ value);
}
/** @event */
public void add_Authenticate (WindowsAuthenticationEventHandler value)
/** @event */
public void remove_Authenticate (WindowsAuthenticationEventHandler value)
JScript unterstützt die Verwendung von Ereignissen, aber nicht die Deklaration von neuen Ereignissen.
Hinweise
Das Authenticate-Ereignis wird während des AuthenticateRequest-Ereignisses ausgelöst.
Sie können auf das Authenticate-Ereignis der WindowsAuthenticationModule-Klasse zugreifen, indem Sie in der Datei Global.asax eine Unterroutine mit dem Namen WindowsAuthentication_OnAuthenticate für die ASP.NET-Anwendung angeben.
Sie können die User-Eigenschaft des für das WindowsAuthentication_OnAuthenticate-Ereignis bereitgestellten WindowsAuthenticationEventArgs-Objekts verwenden, um die User-Eigenschaft des aktuellen HttpContext für ein benutzerdefiniertes IPrincipal-Objekt festzulegen. Wenn Sie für die User-Eigenschaft während des WindowsAuthentication_OnAuthenticate-Ereignisses keinen Wert angeben, wird die von IIS bereitgestellte Windows-Identität als Identität für die aktuelle Anforderung verwendet. Wenn IIS die anonyme Authentifizierung verwendet, wird die Identity-Eigenschaft auf die von der GetAnonymous-Methode zurückgegebene Identität festgelegt.
Das WindowsAuthentication_OnAuthenticate-Ereignis wird nur ausgelöst, wenn der Authentifizierungs-Mode auf Windows festgelegt wurde und WindowsAuthenticationModule ein aktives HTTP-Modul für die Anwendung ist.
Beispiel
Im folgenden Codebeispiel wird die User-Eigenschaft des aktuellen HttpContext mit dem WindowsAuthentication_OnAuthenticate-Ereignis an ein benutzerdefiniertes IPrincipal-Objekt gebunden.
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
public void WindowsAuthentication_OnAuthenticate(object sender, WindowsAuthenticationEventArgs args)
{
if (!args.Identity.IsAnonymous)
{
args.User = new Samples.AspNet.Security.MyPrincipal(args.Identity);
}
}
Plattformen
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
WindowsAuthenticationModule-Klasse
WindowsAuthenticationModule-Member
System.Web.Security-Namespace