DefaultAuthenticationEventHandler Delegera

Definition

Namnområde:
System.Web.Security
Sammansättning:
System.Web.dll

Representerar den metod som hanterar den DefaultAuthentication_OnAuthenticate händelsen för en 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)

Parametrar

sender
Object

Källan till händelsen.

e
DefaultAuthenticationEventArgs

En DefaultAuthenticationEventArgs som innehåller händelsedata.

Exempel

I följande kodexempel används händelsen DefaultAuthentication_OnAuthenticate för att testa om User egenskapen för den aktuella HttpContext är null. Om egenskapen är nullanger User exemplet egenskapen för den aktuella HttpContext till ett GenericPrincipal objekt, där IdentityGenericPrincipal objektet är ett GenericIdentity med Name värdet "default".

Note

Händelsen DefaultAuthentication_OnAuthenticate utlöses före händelsen AuthorizeRequest . Om du anger User egenskapen för den aktuella HttpContext till en anpassad identitet kan det därför påverka programmets beteende. Om du till exempel använder FormsAuthentication klassen och ser till att endast autentiserade användare har åtkomst till din webbplats, genom att använda authorization avsnittet och ange <deny users="?" />, kommer det här exemplet att göra så att elementet deny ignoreras eftersom användaren har ett namn, vilket är "standard". I stället anger <deny users="default" /> du för att se till att endast autentiserade användare kan komma åt din webbplats.

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

Kommentarer

Ombudet DefaultAuthenticationEventHandler definieras för Authenticate händelsen för DefaultAuthenticationModule klassen. Du kan komma åt händelsen Authenticate för klassen DefaultAuthenticationModule genom att ange en underrutin med namnet DefaultAuthentication_OnAuthenticate i filen Global.asax för ditt ASP.NET-program. Händelsen Authenticate utlöses efter AuthenticateRequest händelsen och används för att säkerställa att User egenskapen för den aktuella HttpContext är fylld med ett IPrincipal objekt.

Du kan använda Context egenskapen för det DefaultAuthenticationEventArgs objekt som anges till händelsen DefaultAuthentication_OnAuthenticate för att ange User egenskapen för den aktuella HttpContext till ett anpassat IPrincipal objekt. Om du inte anger ett värde för egenskapen för User den HttpContext angivna under händelsen DefaultAuthentication_OnAuthenticate anger DefaultAuthenticationModuleUser egenskapen HttpContext för till ett GenericPrincipal objekt som inte innehåller någon användarinformation.

Händelsen DefaultAuthentication_OnAuthenticate utlöses efter AuthenticateRequest händelsen och före händelsen AuthorizeRequest . Om du har ett authorization avsnitt som är beroende av användarnamnet för att neka eller tillåta åtkomst till ditt program kan det påverka programmets beteende om du ändrar User egenskapen för den aktuella HttpContext . Se till att användarnamnet som du angav under DefaultAuthentication_OnAuthenticate-händelsen beaktas när du anger authorization avsnittet i konfigurationen.

Tilläggsmetoder

Name Description
GetMethodInfo(Delegate)

Hämtar ett objekt som representerar den metod som representeras av det angivna ombudet.

Gäller för