DefaultAuthenticationEventArgs(HttpContext) Konstruktor

Definíció

Névtér:

System.Web.Security

Szerelvény:

System.Web.dll

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

public:
 DefaultAuthenticationEventArgs(System::Web::HttpContext ^ context);

public DefaultAuthenticationEventArgs(System.Web.HttpContext context);

new System.Web.Security.DefaultAuthenticationEventArgs : System.Web.HttpContext -> System.Web.Security.DefaultAuthenticationEventArgs

Public Sub New (context As HttpContext)

Paraméterek

context

HttpContext

Az esemény környezete.

Példák

Az alábbi példakód a DefaultAuthentication_OnAuthenticate eseményt használja annak ellenőrzésére, hogy az User aktuális HttpContext tulajdonsága.null Ha a tulajdonság aznull, akkor a példa az User aktuális HttpContext tulajdonságot egy GenericPrincipal olyan objektumra állítja, amelyben az IdentityGenericPrincipal objektum tulajdonsága egy GenericIdentity "alapértelmezett" tulajdonságértékkel rendelkező Name objektum.

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 tulajdonságot 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 biztosítja, hogy csak hitelesített felhasználók férhessenek hozzá a webhelyhez, a szakasz használatával authorization és megadásával <deny users="?" />deny a jelen példában szereplő elemet figyelmen kívül fogja hagyni, mivel a felhasználó neve "alapértelmezett". Ehelyett azt szeretné megadni <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

Az DefaultAuthenticationModule objektum egy DefaultAuthenticationEventArgs objektumot az aktuális HttpContext használatával hoz létre, és átadja az DefaultAuthentication_OnAuthenticate eseménynek.

Context Az DefaultAuthenticationEventArgs eseményhez megadott objektum tulajdonságával egyéni objektumra User állíthatja HttpContext az aktuális IPrincipal tulajdonságot. Ha nem ad meg értéket a User tulajdonság által HttpContext hivatkozott tulajdonsághozContext, a DefaultAuthenticationModule tulajdonság tulajdonságát User egy HttpContext olyan objektumra állítjaGenericPrincipal, amely nem tartalmaz felhasználói adatokat.

A DefaultAuthentication_OnAuthenticate esemény az AuthenticateRequest esemény után és az AuthorizeRequest esemény előtt lesz előállítva. Ha olyan szakasza van authorization , amely attól függ, hogy a felhasználónév megtagadja vagy engedélyezi az alkalmazáshoz való hozzáférést, az User aktuális HttpContext tulajdonság módosítása hatással lehet az alkalmazás viselkedésére. Győződjön meg arról, hogy a DefaultAuthentication_OnAuthenticate esemény során beállított felhasználónevet figyelembe veszi a konfiguráció szakaszának authorization megadásakor.

Lásd még

• ASP.NET hitelesítés