FormsAuthenticationEventArgs Osztály

Definíció

Névtér:

System.Web.Security

Szerelvény:

System.Web.dll

Adatokat biztosít a FormsAuthentication_OnAuthenticate eseményhez. Ez az osztály nem örökölhető.

public ref class FormsAuthenticationEventArgs sealed : EventArgs

public sealed class FormsAuthenticationEventArgs : EventArgs

type FormsAuthenticationEventArgs = class
    inherit EventArgs

Public NotInheritable Class FormsAuthenticationEventArgs
Inherits EventArgs

Öröklődés

Object

EventArgs

FormsAuthenticationEventArgs

Példák

Az alábbi példa a FormsAuthentication_OnAuthenticate esemény használatával állítja be az User aktuális HttpContext tulajdonságot egy GenericPrincipal egyéni Identityobjektumra.

public void FormsAuthentication_OnAuthenticate(object sender, FormsAuthenticationEventArgs args)
{
  if (FormsAuthentication.CookiesSupported)
  {
    if (Request.Cookies[FormsAuthentication.FormsCookieName] != null)
    {
      try
      {
        FormsAuthenticationTicket ticket = FormsAuthentication.Decrypt(
          Request.Cookies[FormsAuthentication.FormsCookieName].Value);
        
        args.User = new System.Security.Principal.GenericPrincipal(
          new Samples.AspNet.Security.MyFormsIdentity(ticket),
          new string[0]);
      }
      catch (Exception e)
      {
        // Decrypt method failed.
      }
    }
  }
  else
  {
    throw new HttpException("Cookieless Forms Authentication is not " +
                            "supported for this application.");
  }
}

Public Sub FormsAuthentication_OnAuthenticate(sender As Object, _
                                              args As FormsAuthenticationEventArgs)
  If FormsAuthentication.CookiesSupported Then
    If Not Request.Cookies(FormsAuthentication.FormsCookieName) Is Nothing Then
      Try
        Dim ticket As FormsAuthenticationTicket = FormsAuthentication.Decrypt( _
          Request.Cookies(FormsAuthentication.FormsCookieName).Value)
        
        args.User = New System.Security.Principal.GenericPrincipal( _
          New Samples.AspNet.Security.MyFormsIdentity(ticket), _
          New String(0) {})
      Catch e As HttpException
        ' Decrypt method failed.
      End Try
    End If
  Else
      Throw New Exception("Cookieless Forms Authentication is not " & _
                            "supported for this application.")
  End If
End Sub

Megjegyzések

Az FormsAuthenticationEventArgs osztály az eseményértékek megadására szolgál az FormsAuthentication_OnAuthenticate eseményhez, és lehetővé teszi, hogy egyéni identitást adjon meg az aktuális kéréshez.

Az FormsAuthenticationModule objektumot FormsAuthenticationEventArgs az aktuális HttpContext használatával hozza létre, és továbbítja az FormsAuthentication_OnAuthenticate eseménynek.

A tulajdonság használatával User az User aktuális HttpContext tulajdonságot egyéni IPrincipal objektummá állíthatja.

Ha az UserFormsAuthentication_OnAuthenticate esemény során nem ad meg értéket a tulajdonsághoz, a rendszer az űrlapok hitelesítési jegye által a cookie-ban vagy URL-címen megadott identitást használja.

A FormsAuthentication_OnAuthenticate esemény csak akkor jön létre, ha a hitelesítés Mode be van állítva Forms , és az FormsAuthenticationModule aktív HTTP-modul az alkalmazás számára.

Konstruktorok

Name	Description
FormsAuthenticationEventArgs(HttpContext)	Inicializálja a FormsAuthenticationEventArgs osztály új példányát.

Tulajdonságok

Name	Description
Context	Lekéri az HttpContext aktuális HTTP-kérés objektumát.
User	Lekéri vagy beállítja az IPrincipal aktuális kéréshez társítandó objektumot.

Metódusok

Name	Description
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)
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)

Lásd még

• Űrlaphitelesítési szolgáltató