DefaultAuthenticationEventHandler Gedelegeerde

Definitie

Naamruimte:

System.Web.Security

Assembly:

System.Web.dll

Vertegenwoordigt de methode die de DefaultAuthentication_OnAuthenticate gebeurtenis van een 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)

Parameters

sender

Object

De bron van de gebeurtenis.

e

DefaultAuthenticationEventArgs

Een DefaultAuthenticationEventArgs met de gebeurtenisgegevens.

Voorbeelden

In het volgende codevoorbeeld wordt de DefaultAuthentication_OnAuthenticate gebeurtenis gebruikt om te testen of de User eigenschap van de huidige HttpContext is null. Als de eigenschap is null, stelt het voorbeeld de User eigenschap van de huidige HttpContext in op een GenericPrincipal object, waarbij het Identity object GenericPrincipal een GenericIdentity met de Name waarde 'standaard' is.

Note

De DefaultAuthentication_OnAuthenticate gebeurtenis wordt gegenereerd vóór de AuthorizeRequest gebeurtenis. Als u de eigenschap van de User huidige HttpContext instelt op een aangepaste identiteit, kan dit van invloed zijn op het gedrag van uw toepassing. Als u bijvoorbeeld de FormsAuthentication klasse gebruikt en u ervoor zorgt dat alleen geverifieerde gebruikers toegang hebben tot uw site door de authorization sectie te gebruiken en op te geven <deny users="?" />, wordt het deny element in dit voorbeeld genegeerd, omdat de gebruiker een naam heeft, wat 'standaard' is. In plaats daarvan geeft u op <deny users="default" /> dat alleen geverifieerde gebruikers toegang hebben tot uw 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

Opmerkingen

De DefaultAuthenticationEventHandler gemachtigde wordt gedefinieerd voor de Authenticate gebeurtenis van de DefaultAuthenticationModule klasse. U kunt de gebeurtenis Authenticate van de klasse DefaultAuthenticationModule openen door een subroutine met de naam DefaultAuthentication_OnAuthenticate op te geven in het bestand Global.asax voor uw ASP.NET-toepassing. De Authenticate gebeurtenis wordt gegenereerd na de AuthenticateRequest gebeurtenis en wordt gebruikt om ervoor te zorgen dat de User eigenschap van de huidige HttpContext wordt gevuld met een IPrincipal object.

U kunt de Context eigenschap van het DefaultAuthenticationEventArgs object dat is opgegeven aan de DefaultAuthentication_OnAuthenticate gebeurtenis gebruiken om de User eigenschap van de huidige HttpContext in te stellen op een aangepast IPrincipal object. Als u geen waarde opgeeft voor de eigenschap van de UserHttpContext opgegeven eigenschap tijdens de DefaultAuthentication_OnAuthenticate gebeurtenis, wordt de DefaultAuthenticationModuleUser eigenschap van het HttpContext object ingesteld op een GenericPrincipal object dat geen gebruikersgegevens bevat.

De DefaultAuthentication_OnAuthenticate gebeurtenis wordt gegenereerd na de AuthenticateRequest gebeurtenis en vóór de AuthorizeRequest gebeurtenis. Als u een authorization sectie hebt die afhankelijk is van de gebruikersnaam om toegang tot uw toepassing te weigeren of toe te staan, kan het wijzigen van de User eigenschap van de huidige HttpContext invloed hebben op het gedrag van uw toepassing. Zorg ervoor dat de gebruikersnaam die u tijdens de DefaultAuthentication_OnAuthenticate gebeurtenis instelt, wordt overwogen wanneer u de authorization sectie in uw configuratie opgeeft.

Extensiemethoden

Name	Description
GetMethodInfo(Delegate)	Hiermee haalt u een object op dat de methode vertegenwoordigt die wordt vertegenwoordigd door de opgegeven gemachtigde.