DefaultAuthenticationModule Klas

Definitie

Naamruimte:

System.Web.Security

Assembly:

System.Web.dll

Zorgt ervoor dat een verificatieobject aanwezig is in de context. Deze klasse kan niet worden overgenomen.

public ref class DefaultAuthenticationModule sealed : System::Web::IHttpModule

public sealed class DefaultAuthenticationModule : System.Web.IHttpModule

type DefaultAuthenticationModule = class
    interface IHttpModule

Public NotInheritable Class DefaultAuthenticationModule
Implements IHttpModule

Overname

Object

DefaultAuthenticationModule

Implementeringen

IHttpModule

Voorbeelden

In het volgende voorbeeld wordt de DefaultAuthentication_OnAuthenticate gebeurtenis gebruikt om te testen of de User eigenschap van het huidige HttpContext exemplaar is null. Als de User eigenschap is null, stelt het voorbeeld de User eigenschap van het huidige HttpContext exemplaar in op een GenericPrincipal object waarvan het IdentityGenericPrincipal object 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 het User huidige HttpContext exemplaar 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 opgeeft <deny users="?" /> in de sectie autorisatieconfiguratie om ervoor te zorgen dat alleen geverifieerde gebruikers toegang hebben tot uw site, zorgt dit voorbeeld ervoor dat het weigeringselement wordt 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 DefaultAuthenticationModule eigenschap User van het huidige HttpContext exemplaar wordt ingesteld op een IPrincipal object voor elke aanvraag. De DefaultAuthenticationModule eigenschap wordt na de AuthenticateRequest gebeurtenis en vóór de AuthorizeRequest gebeurtenis onderzochtUser. Als de User eigenschap is null, wordt de DefaultAuthenticationModuleUser eigenschap ingesteld op een GenericPrincipal object dat geen gebruikersgegevens bevat.

Als de verificatiemodule de StatusCode eigenschap instelt op 401, wordt er DefaultAuthenticationModule een foutpagina met geweigerde toegang weergegeven. Als de waarde van de StatusCode eigenschap is ingesteld op een waarde die groter is dan 200, beëindigt het DefaultAuthenticationModule object de aanvraag. In dat geval worden alleen HTTP-modules aangeroepen die zich abonneren op de EndRequest gebeurtenis voordat de huidige aanvraag is voltooid.

Er DefaultAuthenticationModule wordt een Authenticate gebeurtenis weergegeven. U kunt deze gebeurtenis gebruiken om een aangepast IPrincipal object op te geven voor de User eigenschap van het huidige HttpContext exemplaar. De Authenticate gebeurtenis wordt geopend door een gebeurtenis met de naam DefaultAuthentication_OnAuthenticate op te geven in het global.asax-bestand van de toepassing.

Constructors

Name	Description
DefaultAuthenticationModule()	Initialiseert een nieuw exemplaar van de DefaultAuthenticationModule klasse.

Methoden

Name	Description
Dispose()	Alle resources, behalve geheugen, die door de DefaultAuthenticationModule.
Equals(Object)	Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object)
GetHashCode()	Fungeert als de standaardhashfunctie. (Overgenomen van Object)
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
Init(HttpApplication)	Initialiseert het DefaultAuthenticationModule-object.
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
ToString()	Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object)

gebeurtenis

Name	Description
Authenticate	Vindt plaats nadat de aanvraag is geverifieerd.

Zie ook

• ASP.NET authenticatie