WindowsAuthenticationEventHandler Délégué

Définition

Représente la méthode qui gère l’événement WindowsAuthentication_OnAuthenticate d’un WindowsAuthenticationModule.Represents the method that handles the WindowsAuthentication_OnAuthenticate event of a 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.The source of the event.

e
WindowsAuthenticationEventArgs

WindowsAuthenticationEventArgs qui contient les données d'événement.A WindowsAuthenticationEventArgs that contains the event data.

Héritage
WindowsAuthenticationEventHandler

Exemples

L’exemple de code suivant utilise l’événement WindowsAuthentication_OnAuthenticate pour affecter User à la propriété du HttpContext actuel la valeur IPrincipal d’un objet personnalisé.The following code example uses the WindowsAuthentication_OnAuthenticate event to set the User property of the current HttpContext to a custom IPrincipal object.

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' Authenticate événement de la WindowsAuthenticationModule classe.The WindowsAuthenticationEventHandler delegate is defined for the Authenticate event of the WindowsAuthenticationModule class. Vous pouvez accéder à Authenticate l’événement de WindowsAuthenticationModule la classe en spécifiant une sous-routine nommée WindowsAuthentication_OnAuthenticate dans le fichier global. asax de votre application ASP.net.You can access the Authenticate event of the WindowsAuthenticationModule class by specifying a subroutine named WindowsAuthentication_OnAuthenticate in the Global.asax file for your ASP.NET application. L' Authenticate événement est déclenché pendant l' AuthenticateRequest événement.The Authenticate event is raised during the AuthenticateRequest event.

Construit un WindowsAuthenticationEventArgs objet à l’aide de l’identité Windows fournie par IIS et du HttpContext actuel et le passe à l’événement WindowsAuthentication_OnAuthenticate. WindowsAuthenticationModuleThe WindowsAuthenticationModule constructs a WindowsAuthenticationEventArgs object using the Windows identity supplied by IIS and the current HttpContext and passes it to the WindowsAuthentication_OnAuthenticate event.

Vous pouvez utiliser la User propriété de l' WindowsAuthenticationEventArgs objet fourni à l’événement WindowsAuthentication_OnAuthenticate pour affecter à User la propriété du actuel HttpContext la valeur d' IPrincipal un objet personnalisé.You can use the User property of the WindowsAuthenticationEventArgs object supplied to the WindowsAuthentication_OnAuthenticate event to set the User property of the current HttpContext to a custom IPrincipal object. Si vous ne spécifiez pas de valeur pour User la propriété pendant l’événement WindowsAuthentication_OnAuthenticate , l’identité Windows fournie par IIS est utilisée comme identité pour la demande actuelle.If you do not specify a value for the User property during the WindowsAuthentication_OnAuthenticate event, the Windows identity supplied by IIS is used as the identity for the current request. Si IIS utilise l’authentification anonyme, Identity la propriété de l' WindowsAuthenticationEventArgs objet est définie sur l’identité retournée par la GetAnonymous méthode.If IIS uses anonymous authentication, then the Identity property of the WindowsAuthenticationEventArgs object is set to the identity returned by the GetAnonymous method.

L’événement WindowsAuthentication_OnAuthenticate est déclenché uniquement lorsque l’authentification Mode a la WindowsAuthenticationModule valeur Windows et que est un module http actif pour l’application.The WindowsAuthentication_OnAuthenticate event is only raised when the authentication Mode is set to Windows and the WindowsAuthenticationModule is an active HTTP module for the 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é.Gets an object that represents the method represented by the specified delegate.

S’applique à

Voir aussi