WindowsAuthenticationModule.Authenticate Ereignis
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Tritt ein, wenn die Anwendung die aktuelle Anforderung authentifiziert.
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 Ereignistyp
Beispiele
Im folgenden Codebeispiel wird das WindowsAuthentication_OnAuthenticate-Ereignis verwendet, um die User -Eigenschaft des aktuellen HttpContext auf ein benutzerdefiniertes IPrincipal -Objekt festzulegen.
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
Hinweise
Das Authenticate Ereignis wird während des Ereignisses AuthenticateRequest ausgelöst.
Sie können auf das Authenticate Ereignis der WindowsAuthenticationModule -Klasse zugreifen, indem Sie eine Unterroutine mit dem Namen WindowsAuthentication_OnAuthenticate in der Datei Global.asax für Ihre ASP.NET-Anwendung angeben.
Sie können die User -Eigenschaft des -Objekts verwenden, das WindowsAuthenticationEventArgs für das WindowsAuthentication_OnAuthenticate-Ereignis bereitgestellt wird, um die User -Eigenschaft des aktuellen HttpContext auf ein benutzerdefiniertes IPrincipal -Objekt festzulegen. Wenn Sie während des WindowsAuthentication_OnAuthenticate-Ereignisses keinen Wert für die User Eigenschaft angeben, wird die von IIS bereitgestellte Windows-Identität als Identität für die aktuelle Anforderung verwendet. Wenn IIS 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 die Authentifizierung Mode auf Windows festgelegt ist und das WindowsAuthenticationModule ein aktives HTTP-Modul für die Anwendung ist.
Hinweis
In IIS 7.0, das im integrierten Modus ausgeführt wird, wird das Authenticate Ereignis des WindowsAuthenticationModule nicht ausgelöst, wenn sowohl die ASP.NET WindowsAuthenticationModule als auch die IIS-Module AnonymousAuthenticationModule aktiviert sind. Abonnieren Sie in diesem Szenario das -Ereignis der -Instanz, um eine AuthenticateRequest Authentifizierungsbenachrichtigung HttpApplication zu erhalten. Weitere Informationen zu Kompatibilitätsproblemen in integrierten Modi finden Sie unter Verschieben einer ASP.NET-Anwendung von IIS 6.0 zu IIS 7.0.
