Questa documentazione è stata archiviata e non viene gestita.

Delegato WindowsAuthenticationEventHandler

Rappresenta il metodo di gestione dell'evento WindowsAuthentication_OnAuthenticate di un oggetto WindowsAuthenticationModule.

Spazio dei nomi: System.Web.Security
Assembly: System.Web (in system.web.dll)

public delegate void WindowsAuthenticationEventHandler (
	Object sender,
	WindowsAuthenticationEventArgs e
)
/** @delegate */
public delegate void WindowsAuthenticationEventHandler (
	Object sender, 
	WindowsAuthenticationEventArgs e
)
JScript supporta l'utilizzo di delegati ma non la dichiarazione di nuovi.

Parametri

sender

Origine dell'evento.

e

Classe WindowsAuthenticationEventArgs che contiene i dati dell'evento.

Il delegato WindowsAuthenticationEventHandler è definito per l'evento Authenticate della classe WindowsAuthenticationModule. È possibile accedere all'evento Authenticate della classe WindowsAuthenticationModule specificando una subroutine denominata WindowsAuthentication_OnAuthenticate nel file Global.asax dell'applicazione ASP.NET. L'evento Authenticate viene generato durante l'evento AuthenticateRequest.

L'oggetto WindowsAuthenticationModule consente di creare un oggetto WindowsAuthenticationEventArgs utilizzando l'identità Windows fornita da IIS e dall'oggetto HttpContext corrente e lo passa all'evento WindowsAuthentication_OnAuthenticate.

È possibile utilizzare la proprietà User dell'oggetto WindowsAuthenticationEventArgs fornito all'evento WindowsAuthentication_OnAuthenticate per impostare la proprietà User dell'oggetto corrente HttpContext su un oggetto IPrincipal personalizzato. Se non viene specificato un valore per la proprietà User durante l'evento WindowsAuthentication_OnAuthenticate, l'identità Windows fornita da IIS viene utilizzata come identità della richiesta corrente. Se in IIS è utilizzata l'autenticazione anonima, la proprietà Identity dell'oggetto WindowsAuthenticationEventArgs è impostata sull'identità restituita dal metodo GetAnonymous.

L'evento WindowsAuthentication_OnAuthenticate viene generato solo quando l'oggetto Mode di autenticazione è impostato su Windows e WindowsAuthenticationModule è un modulo HTTP attivo per l'applicazione.

Nell'esempio di codice riportato di seguito viene utilizzato l'evento WindowsAuthentication_OnAuthenticate per impostare la proprietà User dell'oggetto HttpContext corrente su un oggetto IPrincipal personalizzato.

public void WindowsAuthentication_OnAuthenticate(object sender, WindowsAuthenticationEventArgs args)
{
  if (!args.Identity.IsAnonymous)
  {
    args.User = new Samples.AspNet.Security.MyPrincipal(args.Identity);
  }
}

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 non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema.

.NET Framework

Supportato in: 2.0 1.1 1.0
Mostra: