DefaultAuthenticationModule Osztály

Definíció

Névtér:
System.Web.Security
Szerelvény:
System.Web.dll

Biztosítja, hogy egy hitelesítési objektum jelen legyen a környezetben. Ez az osztály nem örökölhető.

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
Öröklődés
Object
DefaultAuthenticationModule
Megvalósítás
IHttpModule

Példák

Az alábbi példa a DefaultAuthentication_OnAuthenticate eseményt használja annak ellenőrzésére, hogy az User aktuális HttpContext példány tulajdonsága.null Ha a User tulajdonság aznull, akkor a minta az User aktuális HttpContext példány tulajdonságát egy GenericPrincipal olyan objektumra állítja, amelyben az IdentityGenericPrincipal objektum GenericIdentityName értéke "alapértelmezett".

Note

A DefaultAuthentication_OnAuthenticate esemény az AuthorizeRequest esemény előtt lesz előállítva. Ennek eredményeképpen, ha az User aktuális HttpContext példány tulajdonságát egyéni identitásra állítja be, az hatással lehet az alkalmazás viselkedésére. Ha például az FormsAuthentication osztályt használja, és az <deny users="?" /> konfigurációs szakaszban megadja, hogy csak hitelesített felhasználók férhessenek hozzá a webhelyhez, ez a minta figyelmen kívül hagyja a megtagadási elemet, mivel a felhasználónak lesz egy neve, amely "alapértelmezett". Ehelyett azt kell megadnia<deny users="default" />, hogy csak hitelesített felhasználók férhessenek hozzá a webhelyhez.

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

Megjegyzések

Ez DefaultAuthenticationModule biztosítja, hogy az User aktuális HttpContext példány tulajdonsága minden kéréshez egy IPrincipal objektumra legyen beállítva. Az DefaultAuthenticationModule esemény után és az User esemény előtt megvizsgálja AuthenticateRequest a tulajdonságotAuthorizeRequest. Ha a User tulajdonság aznull, a DefaultAuthenticationModule tulajdonságot egy User olyan objektumra állítja beGenericPrincipal, amely nem tartalmaz felhasználói adatokat.

Ha a hitelesítési modul a StatusCode tulajdonságot a 401 értékre állítja, a DefaultAuthenticationModule rendszer egy hozzáférés-megtagadás hibaoldalt jelenít meg. Ha a StatusCode tulajdonság értéke 200-nál nagyobb értékre van állítva, az DefaultAuthenticationModule objektum befejezi a kérést. Ebben az esetben csak az EndRequest eseményre előfizető HTTP-modulok lesznek meghívva az aktuális kérés befejezése előtt.

A DefaultAuthenticationModule rendszer közzétett egy eseményt Authenticate . Ezzel az eseménysel egyéni IPrincipal objektumot adhat meg az User aktuális HttpContext példány tulajdonságához. Az Authenticate esemény egy DefaultAuthentication_OnAuthenticate nevű esemény megadásával érhető el az alkalmazás Global.asax fájljában.

Konstruktorok

Name Description
DefaultAuthenticationModule()

Inicializálja a DefaultAuthenticationModule osztály új példányát.

Metódusok

Name Description
Dispose()

Felszabadítja az összes erőforrást, a memória kivételével, amelyet a DefaultAuthenticationModulerendszer használ.
Equals(Object)

Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal.

(Öröklődés forrása Object)
GetHashCode()

Ez az alapértelmezett kivonatoló függvény.

(Öröklődés forrása Object)
GetType()

Lekéri az Type aktuális példányt.

(Öröklődés forrása Object)
Init(HttpApplication)

Inicializálja a DefaultAuthenticationModule objektumot.
MemberwiseClone()

Az aktuális Objectpéldány sekély másolatát hozza létre.

(Öröklődés forrása Object)
ToString()

Az aktuális objektumot jelképező sztringet ad vissza.

(Öröklődés forrása Object)

esemény

Name Description
Authenticate

A kérelem hitelesítése után következik be.

A következőre érvényes:

Lásd még