WindowsAuthenticationModule.Authenticate Gebeurtenis
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Vindt plaats wanneer de toepassing de huidige aanvraag verifieert.
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 Gebeurtenistype
Voorbeelden
In het volgende codevoorbeeld wordt de gebeurtenis WindowsAuthentication_OnAuthenticate gebruikt om de User eigenschap van de huidige HttpContext in te stellen op een aangepast IPrincipal object.
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
Opmerkingen
De Authenticate gebeurtenis wordt gegenereerd tijdens de AuthenticateRequest gebeurtenis.
U kunt de gebeurtenis Authenticate van de klasse WindowsAuthenticationModule openen door een subroutine met de naam WindowsAuthentication_OnAuthenticate op te geven in het bestand Global.asax voor uw ASP.NET-toepassing.
U kunt de User eigenschap van het WindowsAuthenticationEventArgs object dat is opgegeven aan de gebeurtenis WindowsAuthentication_OnAuthenticate gebruiken om de User eigenschap van het huidige HttpContext in te stellen op een aangepast IPrincipal object. Als u geen waarde opgeeft voor de eigenschap User tijdens de gebeurtenis WindowsAuthentication_OnAuthenticate, wordt de Windows identiteit die door IIS wordt geleverd, gebruikt als de identiteit voor de huidige aanvraag. Als IIS anonieme verificatie gebruikt, wordt de Identity eigenschap ingesteld op de identiteit die door de GetAnonymous methode wordt geretourneerd.
De gebeurtenis WindowsAuthentication_OnAuthenticate wordt alleen gegenereerd wanneer de verificatie Mode is ingesteld op Windows en de WindowsAuthenticationModule een actieve HTTP-module voor de toepassing is.
Note
In IIS 7.0 die wordt uitgevoerd in de geïntegreerde modus, wordt de gebeurtenis Authenticate van de WindowsAuthenticationModule niet gegenereerd wanneer zowel de modules ASP.NET WindowsAuthenticationModule als de IIS-AnonymousAuthenticationModule modules zijn ingeschakeld. Als u in dit scenario verificatiemeldingen wilt ontvangen, abonneert u zich op de AuthenticateRequest gebeurtenis van het HttpApplication exemplaar. Zie voor meer informatie over compatibiliteitsproblemen in geïntegreerde modi Moving an ASP.NET Application from IIS 6.0 to IIS 7.0.