WindowsAuthenticationEventHandler Delegato

Definizione

Spazio dei nomi:

System.Web.Security

Assembly:

System.Web.dll

Rappresenta il metodo che gestisce l'evento WindowsAuthentication_OnAuthenticate di un 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)

Parametri

sender

Object

Origine dell'evento.

e

WindowsAuthenticationEventArgs

Oggetto WindowsAuthenticationEventArgs che contiene i dati dell'evento.

Esempio

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

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

Commenti

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

Costruisce WindowsAuthenticationModule un WindowsAuthenticationEventArgs oggetto usando l'identità di Windows fornita da IIS e l'oggetto corrente HttpContext e lo passa all'evento WindowsAuthentication_OnAuthenticate .

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

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

Metodi di estensione

GetMethodInfo(Delegate)

Ottiene un oggetto che rappresenta il metodo rappresentato dal delegato specificato.

Vedi anche

• Provider di autenticazione di Windows