FormsAuthenticationEventArgs Kelas

Definisi

Ruang nama:

System.Web.Security

Rakitan:

System.Web.dll

Menyediakan data untuk peristiwa FormsAuthentication_OnAuthenticate . Kelas ini tidak dapat diwariskan.

public ref class FormsAuthenticationEventArgs sealed : EventArgs

public sealed class FormsAuthenticationEventArgs : EventArgs

type FormsAuthenticationEventArgs = class
    inherit EventArgs

Public NotInheritable Class FormsAuthenticationEventArgs
Inherits EventArgs

Warisan

Object

EventArgs

FormsAuthenticationEventArgs

Contoh

Contoh kode berikut menggunakan peristiwa FormsAuthentication_OnAuthenticate untuk mengatur User properti saat ini HttpContext ke GenericPrincipal objek dengan kustom Identity.

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

Keterangan

Kelas FormsAuthenticationEventArgs ini digunakan untuk menyediakan nilai peristiwa ke peristiwa FormsAuthentication_OnAuthenticate dan memungkinkan Anda menentukan identitas kustom untuk permintaan saat ini.

FormsAuthenticationEventArgs Membuat FormsAuthenticationModule objek menggunakan saat ini HttpContext dan meneruskannya ke peristiwa FormsAuthentication_OnAuthenticate.

Anda dapat menggunakan User properti untuk mengatur User properti saat ini HttpContext ke objek kustom IPrincipal .

Jika Anda tidak menentukan nilai untuk User properti selama peristiwa FormsAuthentication_OnAuthenticate , identitas yang disediakan oleh tiket autentikasi formulir di cookie atau URL akan digunakan.

Peristiwa FormsAuthentication_OnAuthenticate hanya dinaikkan ketika autentikasi Mode diatur ke Forms dan FormsAuthenticationModule adalah modul HTTP aktif untuk aplikasi.

Konstruktor

FormsAuthenticationEventArgs(HttpContext)

Menginisialisasi instans baru kelas FormsAuthenticationEventArgs.

Properti

Context	HttpContext Mendapatkan objek untuk permintaan HTTP saat ini.
User	Mendapatkan atau mengatur objek yang IPrincipal akan dikaitkan dengan permintaan saat ini.

Metode

Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Lihat juga

• Penyedia Autentikasi Formulir