WindowsAuthenticationEventHandler Delegera

Definition

public delegate void WindowsAuthenticationEventHandler(System::Object ^ sender, WindowsAuthenticationEventArgs ^ e);

public delegate void WindowsAuthenticationEventHandler(object sender, WindowsAuthenticationEventArgs e);

type WindowsAuthenticationEventHandler = delegate of obj * WindowsAuthenticationEventArgs -> unit

Public Delegate Sub WindowsAuthenticationEventHandler(sender As Object, e As WindowsAuthenticationEventArgs)

Parametrar

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

Ombudet WindowsAuthenticationEventHandler definieras för Authenticate händelsen för WindowsAuthenticationModule klassen. 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. Händelsen Authenticate utlöses under AuthenticateRequest händelsen.

WindowsAuthenticationModule konstruerar ett WindowsAuthenticationEventArgs-objekt med hjälp av den Windows identitet som tillhandahålls av IIS och den aktuella HttpContext och skickar det till händelsen WindowsAuthentication_OnAuthenticate.

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 ställs objektets WindowsAuthenticationEventArgs egenskap in på 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.

Se även

• Windows-autentiseringsprovider