DefaultAuthenticationEventHandler Delegado

Definición

Representa el método que controla el evento DefaultAuthentication_OnAuthenticate de 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)

Parámetros

sender
Object

Origen del evento.The source of the event.

e
DefaultAuthenticationEventArgs

Objeto DefaultAuthenticationEventArgs que contiene los datos del evento.A DefaultAuthenticationEventArgs that contains the event data.

Ejemplos

En el ejemplo de código siguiente se utiliza el evento DefaultAuthentication_OnAuthenticate para comprobar si la User propiedad del actual HttpContext es null .The following code example uses the DefaultAuthentication_OnAuthenticate event to test whether the User property of the current HttpContext is null. Si la propiedad es null , el ejemplo establece la User propiedad del objeto actual HttpContext en un GenericPrincipal objeto, donde el Identity del GenericPrincipal objeto es un GenericIdentity con un Name valor de "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".

Nota

El evento DefaultAuthentication_OnAuthenticate se genera antes que el AuthorizeRequest evento.The DefaultAuthentication_OnAuthenticate event is raised before the AuthorizeRequest event. Como resultado, si establece la User propiedad del actual HttpContext en una identidad personalizada, puede afectar al comportamiento de la aplicación.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. Por ejemplo, si usa la FormsAuthentication clase y está asegurándose de que solo los usuarios autenticados tienen acceso a su sitio, mediante la sección y especificando <deny users="?" /> , este ejemplo hará que se omita el elemento, ya que el usuario tendrá un nombre, que es "predeterminado".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". En su lugar, debe especificar <deny users="default" /> para asegurarse de que solo los usuarios autenticados puedan tener acceso a su sitio.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

Comentarios

El DefaultAuthenticationEventHandler delegado se define para el Authenticate evento de la DefaultAuthenticationModule clase.The DefaultAuthenticationEventHandler delegate is defined for the Authenticate event of the DefaultAuthenticationModule class. Puede tener acceso al Authenticate evento de la DefaultAuthenticationModule clase especificando una subrutina denominada DefaultAuthentication_OnAuthenticate en el archivo global. asax de la aplicación 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. El Authenticate evento se desencadena después del AuthenticateRequest evento y se utiliza para asegurarse de que la User propiedad del HttpContext objeto actual se rellena con un IPrincipal objeto.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.

Puede utilizar la Context propiedad del DefaultAuthenticationEventArgs objeto proporcionado al evento DefaultAuthentication_OnAuthenticate para establecer la User propiedad del HttpContext objeto actual en un IPrincipal objeto personalizado.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 no especifica un valor para la User propiedad del HttpContext proporcionado durante el evento de DefaultAuthentication_OnAuthenticate , DefaultAuthenticationModule establece la User propiedad de HttpContext en un GenericPrincipal objeto que no contiene información de usuario.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.

El evento DefaultAuthentication_OnAuthenticate se genera después del AuthenticateRequest evento y antes del AuthorizeRequest evento.The DefaultAuthentication_OnAuthenticate event is raised after the AuthenticateRequest event and before the AuthorizeRequest event. Si tiene una sección que depende del nombre de usuario para denegar o permitir el acceso a la aplicación, la modificación de la User propiedad del actual HttpContext puede afectar al comportamiento de la aplicación.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. Asegúrese de que el nombre de usuario que estableció durante el evento DefaultAuthentication_OnAuthenticate se tenga en cuenta al especificar la sección en la configuración.Be sure that the user name you set during the DefaultAuthentication_OnAuthenticate event is considered when you specify the section in your configuration.

Métodos de extensión

GetMethodInfo(Delegate)

Obtiene un objeto que representa el método representado por el delegado especificado.Gets an object that represents the method represented by the specified delegate.

Se aplica a