DefaultAuthenticationEventHandler Délégué

Définition

Représente la méthode qui gère l’événement DefaultAuthentication_OnAuthenticate d’un DefaultAuthenticationModule.Represents the method that handles the DefaultAuthentication_OnAuthenticate event of a DefaultAuthenticationModule.

public delegate void DefaultAuthenticationEventHandler(System::Object ^ sender, DefaultAuthenticationEventArgs ^ e);
public delegate void DefaultAuthenticationEventHandler(object sender, DefaultAuthenticationEventArgs e);
type DefaultAuthenticationEventHandler = delegate of obj * DefaultAuthenticationEventArgs -> unit
Public Delegate Sub DefaultAuthenticationEventHandler(sender As Object, e As DefaultAuthenticationEventArgs)

Paramètres

sender
Object

Source de l'événement.The source of the event.

e
DefaultAuthenticationEventArgs

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

Héritage
DefaultAuthenticationEventHandler

Exemples

L’exemple de code suivant utilise l’événement DefaultAuthentication_OnAuthenticate pour déterminer si User la propriété du en HttpContext cours nullest.The following code example uses the DefaultAuthentication_OnAuthenticate event to test whether the User property of the current HttpContext is null. Si la propriété a nullla Identity HttpContext Name valeur, l’exemple User affecte à la propriété du actuel GenericPrincipal la valeur d’un objet, GenericPrincipal où le de GenericIdentity l’objet est un avec la valeur «default». ".If the property is null, the sample sets the User property of the current HttpContext to a GenericPrincipal object, where the Identity of the GenericPrincipal object is a GenericIdentity with a Name value of "default".

Notes

L’événement DefaultAuthentication_OnAuthenticate est déclenché avant l' AuthorizeRequest événement.The DefaultAuthentication_OnAuthenticate event is raised before the AuthorizeRequest event. Par conséquent, si vous affectez à User la propriété du actuel HttpContext une identité personnalisée, cela peut affecter le comportement de votre application.As a result, if you set the User property of the current HttpContext to a custom identity, it can affect the behavior of your application. Par exemple, si vous utilisez la FormsAuthentication classe et que seuls les utilisateurs authentifiés ont accès à votre site, en utilisant la section et en spécifiant <deny users="?" />, cet exemple entraînera l’ignorance de l’élément, car l’utilisateur aura un nom, qui est «default».For example, if you are using the FormsAuthentication class and you are ensuring that only authenticated users have access to your site, by using the section and specifying <deny users="?" />, this sample will cause the element to be ignored, as the user will have a name, which is "default". Au lieu de cela <deny users="default" /> , vous devez spécifier pour vous assurer que seuls les utilisateurs authentifiés peuvent accéder à votre site.Instead you would specify <deny users="default" /> to ensure that only authenticated users can access your site.

public void DefaultAuthentication_OnAuthenticate(object sender,
                                                 DefaultAuthenticationEventArgs args)
{
  if (args.Context.User == null)
    args.Context.User = 
      new System.Security.Principal.GenericPrincipal(
        new System.Security.Principal.GenericIdentity("default"),
        new String[0]);
}
Public Sub DefaultAuthentication_OnAuthenticate(sender As Object, _
                                                args As DefaultAuthenticationEventArgs)
  If args.Context.User Is Nothing Then
    args.Context.User = _
      new System.Security.Principal.GenericPrincipal( _
        new System.Security.Principal.GenericIdentity("default"), _
        new String(0) {})
  End If
End Sub

Remarques

Le DefaultAuthenticationEventHandler délégué est défini pour l' Authenticate événement de la DefaultAuthenticationModule classe.The DefaultAuthenticationEventHandler delegate is defined for the Authenticate event of the DefaultAuthenticationModule class. Vous pouvez accéder à Authenticate l’événement de DefaultAuthenticationModule la classe en spécifiant une sous-routine nommée DefaultAuthentication_OnAuthenticate dans le fichier global. asax de votre application ASP.net.You can access the Authenticate event of the DefaultAuthenticationModule class by specifying a subroutine named DefaultAuthentication_OnAuthenticate in the Global.asax file for your ASP.NET application. L' Authenticate événement est déclenché après l' AuthenticateRequest événement et est utilisé pour garantir que la User propriété du actuel HttpContext est remplie avec un IPrincipal objet.The Authenticate event is raised after the AuthenticateRequest event and is used to ensure that the User property of the current HttpContext is populated with an IPrincipal object.

Vous pouvez utiliser la Context propriété de l' DefaultAuthenticationEventArgs objet fourni à l’événement DefaultAuthentication_OnAuthenticate pour affecter à User la propriété de l' HttpContext objet actuel la IPrincipal valeur d’un objet personnalisé.You can use the Context property of the DefaultAuthenticationEventArgs object supplied to the DefaultAuthentication_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é HttpContext du fourni pendant l’événement DefaultAuthentication_OnAuthenticate DefaultAuthenticationModule HttpContext , le définit la User propriété du sur un GenericPrincipal . objet qui ne contient aucune information utilisateur.If you do not specify a value for the User property of the HttpContext supplied during the DefaultAuthentication_OnAuthenticate event, the DefaultAuthenticationModule sets the User property of the HttpContext to a GenericPrincipal object that contains no user information.

L’événement DefaultAuthentication_OnAuthenticate est déclenché après l' AuthenticateRequest événement et avant l' AuthorizeRequest événement.The DefaultAuthentication_OnAuthenticate event is raised after the AuthenticateRequest event and before the AuthorizeRequest event. Si vous avez une section qui dépend du nom d’utilisateur pour refuser ou autoriser l’accès à votre application, la modification User de la propriété du HttpContext actuel peut affecter le comportement de votre application.If you have an section that depends on the user name to deny or allow access to your application, modifying the User property of the current HttpContext can affect the behavior of your application. Assurez-vous que le nom d’utilisateur que vous avez défini pendant l’événement DefaultAuthentication_OnAuthenticate est pris en compte lorsque vous spécifiez la section dans votre configuration.Be sure that the user name you set during the DefaultAuthentication_OnAuthenticate event is considered when you specify the section in your configuration.

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 à