WindowsAuthenticationEventArgs-Klasse
Stellt Daten für das WindowsAuthentication_OnAuthenticate-Ereignis bereit. Diese Klasse kann nicht geerbt werden.
Namespace: System.Web.Security
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Public NotInheritable Class WindowsAuthenticationEventArgs
Inherits EventArgs
'Usage
Dim instance As WindowsAuthenticationEventArgs
public sealed class WindowsAuthenticationEventArgs : EventArgs
public ref class WindowsAuthenticationEventArgs sealed : public EventArgs
public final class WindowsAuthenticationEventArgs extends EventArgs
public final class WindowsAuthenticationEventArgs extends EventArgs
Hinweise
Mit der WindowsAuthenticationEventArgs-Klasse werden Ereigniswerte an das WindowsAuthentication_OnAuthenticate-Ereignis übergeben und die Angabe einer benutzerdefinierten Windows-Identität für die aktuelle Anforderung ermöglicht.
Das WindowsAuthenticationModule erstellt ein WindowsAuthenticationEventArgs-Objekt mit der von IIS (Internet Information Services, Internetinformationsdienste) und dem aktuellen HttpContext bereitgestellten Windows-Identität und übergibt es an das WindowsAuthentication_OnAuthenticate-Ereignis.
Sie können die User-Eigenschaft des für das WindowsAuthentication_OnAuthenticate-Ereignis bereitgestellten WindowsAuthenticationEventArgs-Objekts verwenden, um die User-Eigenschaft des aktuellen HttpContext für ein benutzerdefiniertes IPrincipal-Objekt festzulegen. Wenn Sie für die User-Eigenschaft während des WindowsAuthentication_OnAuthenticate-Ereignisses keinen Wert 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 auf die von der GetAnonymous-Methode zurückgegebene Identität festgelegt.
Das WindowsAuthentication_OnAuthenticate-Ereignis wird nur ausgelöst, wenn der Authentifizierungs-Mode auf Windows festgelegt wurde und WindowsAuthenticationModule ein aktives HTTP-Modul für die Anwendung ist.
Beispiel
Im folgenden Codebeispiel wird die User-Eigenschaft des aktuellen HttpContext mit dem WindowsAuthentication_OnAuthenticate-Ereignis an ein benutzerdefiniertes IPrincipal-Objekt gebunden.
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
public void WindowsAuthentication_OnAuthenticate(object sender, WindowsAuthenticationEventArgs args)
{
if (!args.Identity.IsAnonymous)
{
args.User = new Samples.AspNet.Security.MyPrincipal(args.Identity);
}
}
.NET Framework-Sicherheit
- AspNetHostingPermission für das Verwenden der WindowsAuthenticationEventArgs-Klasse in einer Hostumgebung. Anforderungswert: LinkDemand. Berechtigungswert: Minimal.
Vererbungshierarchie
System.Object
System.EventArgs
System.Web.Security.WindowsAuthenticationEventArgs
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Plattformen
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
WindowsAuthenticationEventArgs-Member
System.Web.Security-Namespace