WindowsAuthenticationModule.Authenticate Zdarzenie
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Występuje, gdy aplikacja uwierzytelnia bieżące żądanie.
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
Typ zdarzenia
Przykłady
W poniższym przykładzie kodu użyto zdarzenia WindowsAuthentication_OnAuthenticate , aby ustawić User właściwość bieżącego HttpContext obiektu na obiekt niestandardowy 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
Uwagi
Zdarzenie Authenticate jest zgłaszane podczas AuthenticateRequest zdarzenia.
Dostęp do zdarzenia WindowsAuthenticationModule klasy można uzyskaćAuthenticate, określając podproceduty o nazwie WindowsAuthentication_OnAuthenticate w pliku Global.asax dla aplikacji ASP.NET.
Możesz użyć User właściwości obiektu dostarczonego WindowsAuthenticationEventArgs do zdarzenia WindowsAuthentication_OnAuthenticate , aby ustawić User właściwość bieżącego HttpContext obiektu na obiekt niestandardowy IPrincipal . Jeśli nie określisz wartości właściwości User podczas zdarzenia WindowsAuthentication_OnAuthenticate , tożsamość systemu Windows dostarczona przez usługi IIS będzie używana jako tożsamość bieżącego żądania. Jeśli usługi IIS używają uwierzytelniania anonimowego, Identity właściwość jest ustawiona na tożsamość zwróconą przez metodę GetAnonymous .
Zdarzenie WindowsAuthentication_OnAuthenticate jest zgłaszane tylko wtedy, gdy uwierzytelnianie Mode jest ustawione na Windows i WindowsAuthenticationModule jest aktywnym modułem HTTP dla aplikacji.
Uwaga
W usługach IIS 7.0 uruchomionych w trybie zintegrowanym zdarzenie WindowsAuthenticationModule nie jest zgłaszane, Authenticate gdy włączono zarówno ASP.NET, WindowsAuthenticationModule jak i moduły usług IISAnonymousAuthenticationModule
. W tym scenariuszu, aby otrzymywać AuthenticateRequest powiadomienia uwierzytelniania, subskrybuj zdarzenie HttpApplication wystąpienia. Aby uzyskać więcej informacji na temat problemów ze zgodnością w trybach zintegrowanych, zobacz Przenoszenie aplikacji ASP.NET z usług IIS 6.0 do usług IIS 7.0.