WindowsAuthenticationEventHandler Délégué

Définition

Espace de noms:

System.Web.Security

Assembly:

System.Web.dll

Représente la méthode qui gère l’événement WindowsAuthentication_OnAuthenticate d’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)

Paramètres

sender

Object

Source de l'événement.

e

WindowsAuthenticationEventArgs

WindowsAuthenticationEventArgs qui contient les données d’événement.

Exemples

L’exemple de code suivant utilise l’événement WindowsAuthentication_OnAuthenticate pour définir la User propriété du actif HttpContext sur un objet personnalisé 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

Remarques

Le WindowsAuthenticationEventHandler délégué est défini pour l’événement Authenticate de la WindowsAuthenticationModule classe . Vous pouvez accéder à l’événement Authenticate de la WindowsAuthenticationModule classe en spécifiant une sous-routine nommée WindowsAuthentication_OnAuthenticate dans le fichier Global.asax pour votre application ASP.NET. L’événement Authenticate est déclenché pendant l’événement AuthenticateRequest .

Construit WindowsAuthenticationModule un WindowsAuthenticationEventArgs objet à l’aide de l’identité Windows fournie par IIS et du actuel HttpContext et le transmet à l’événement WindowsAuthentication_OnAuthenticate .

Vous pouvez utiliser la User propriété de l’objet WindowsAuthenticationEventArgs fourni à l’événement WindowsAuthentication_OnAuthenticate pour définir la User propriété du actif HttpContext sur un objet personnalisé IPrincipal . Si vous ne spécifiez pas de valeur pour la User propriété pendant l’événement WindowsAuthentication_OnAuthenticate , l’identité Windows fournie par IIS est utilisée comme identité pour la requête actuelle. Si IIS utilise l’authentification anonyme, la Identity propriété de l’objet WindowsAuthenticationEventArgs est définie sur l’identité retournée par la GetAnonymous méthode.

L’événement WindowsAuthentication_OnAuthenticate est déclenché uniquement lorsque l’authentification Mode est définie sur Windows et que le WindowsAuthenticationModule est un module HTTP actif pour l’application.

Méthodes d’extension

GetMethodInfo(Delegate)

Obtient un objet qui représente la méthode représentée par le délégué spécifié.

Voir aussi

• Fournisseur d’authentification Windows