WindowsAuthenticationModule.Authenticate Händelse

Definition

Namnområde:
System.Web.Security
Sammansättning:
System.Web.dll

Inträffar när programmet autentiserar den aktuella begäran.

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

Händelsetyp

WindowsAuthenticationEventHandler

Exempel

I följande kodexempel används händelsen WindowsAuthentication_OnAuthenticate för att ange User egenskapen för den aktuella HttpContext till ett anpassat IPrincipal objekt.

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

Kommentarer

Händelsen Authenticate utlöses under AuthenticateRequest händelsen.

Du kan komma åt händelsen Authenticate för klassen WindowsAuthenticationModule genom att ange en underrutin med namnet WindowsAuthentication_OnAuthenticate i filen Global.asax för ditt ASP.NET-program.

Du kan använda User egenskapen för det WindowsAuthenticationEventArgs objekt som anges till händelsen WindowsAuthentication_OnAuthenticate för att ange User egenskapen för den aktuella HttpContext till ett anpassat IPrincipal objekt. Om du inte anger något värde för egenskapen User under händelsen WindowsAuthentication_OnAuthenticate används den Windows identitet som tillhandahålls av IIS som identitet för den aktuella begäran. Om IIS använder anonym autentisering Identity anges egenskapen till den identitet som returneras av GetAnonymous metoden.

Händelsen WindowsAuthentication_OnAuthenticate utlöses endast när autentiseringen Mode är inställd på Windows och WindowsAuthenticationModule är en aktiv HTTP-modul för programmet.

Note

I IIS 7.0 som körs i integrerat läge aktiveras inte händelsen Authenticate för WindowsAuthenticationModule när både ASP.NET WindowsAuthenticationModule och IIS-modulerna AnonymousAuthenticationModule aktiveras. Om du vill ta emot autentiseringsmeddelandet i det här scenariot prenumererar du på AuthenticateRequest instansens HttpApplication händelse. Mer information om kompatibilitetsproblem i integrerade lägen finns i Moving an ASP.NET Application from IIS 6.0 to IIS 7.0.

Gäller för

Se även