Freigeben über

WindowsAuthenticationEventHandler Delegat

Definition

Namespace:
System.Web.Security
Assembly:
System.Web.dll

Stellt die Methode dar, die das WindowsAuthentication_OnAuthenticate Ereignis eines .WindowsAuthenticationModule

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 Objekt, das die Ereignisdaten enthält.

Beispiele

Im folgenden Codebeispiel wird das WindowsAuthentication_OnAuthenticate-Ereignis verwendet, um die User Eigenschaft des aktuellen HttpContext Objekts 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 Delegat WindowsAuthenticationEventHandler wird für das Authenticate Ereignis der WindowsAuthenticationModule Klasse definiert. Sie können auf das Authenticate Ereignis der WindowsAuthenticationModule Klasse zugreifen, indem Sie eine Unterroutine namens 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.

Das WindowsAuthenticationModule Erstellt ein WindowsAuthenticationEventArgs Objekt mit der von IIS bereitgestellten Windows-Identität und dem aktuellen HttpContext Objekt und übergibt es an das WindowsAuthentication_OnAuthenticate-Ereignis .

Sie können die User Eigenschaft des Objekts verwenden, das WindowsAuthenticationEventArgs dem WindowsAuthentication_OnAuthenticate-Ereignis bereitgestellt wird, um die User Eigenschaft des aktuellen HttpContext Objekts 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 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 ein WindowsAuthenticationModule aktives HTTP-Modul für die Anwendung festgelegt Windows ist.

Erweiterungsmethoden

Name Beschreibung
GetMethodInfo(Delegate)

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

Gilt für:

Weitere Informationen