WindowsAuthenticationEventHandler Delegat

Definition

Namespace:

System.Web.Security

Assembly:

System.Web.dll

Stellt eine Methode dar, der das WindowsAuthentication_OnAuthenticate-Ergebnis eines WindowsAuthenticationModule behandelt.

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)

Parameter

sender

Object

Die Quelle des Ereignisses.

e

WindowsAuthenticationEventArgs

Ein WindowsAuthenticationEventArgs, das die Ereignisdaten enthält.

Beispiele

Im folgenden Codebeispiel wird das WindowsAuthentication_OnAuthenticate-Ereignis verwendet, um die User Eigenschaft des current 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

Der WindowsAuthenticationEventHandler Delegat ist für das Authenticate Ereignis der WindowsAuthenticationModule -Klasse definiert. 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. Das Authenticate Ereignis wird während des Ereignisses AuthenticateRequest ausgelöst.

Der WindowsAuthenticationModule erstellt ein WindowsAuthenticationEventArgs Objekt unter Verwendung der von IIS bereitgestellten Windows-Identität und der aktuellen HttpContext und übergibt es an das WindowsAuthentication_OnAuthenticate-Ereignis .

Sie können die User -Eigenschaft des -Objekts verwenden, das WindowsAuthenticationEventArgs für das WindowsAuthentication_OnAuthenticate-Ereignis bereitgestellt wird, um die User Eigenschaft des current 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 die anonyme Authentifizierung verwendet, wird die Identity -Eigenschaft des WindowsAuthenticationEventArgs -Objekts 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 ist ein aktives HTTP-Modul für die Anwendung.

Erweiterungsmethoden

GetMethodInfo(Delegate)

Ruft ein Objekt ab, das die Methode darstellt, die vom angegebenen Delegaten dargestellt wird.

Weitere Informationen

• Windows-Authentifizierungsanbieter