FormsAuthenticationModule Kelas

Definisi

Ruang nama:

System.Web.Security

Rakitan:

System.Web.dll

Mengatur identitas pengguna untuk aplikasi ASP.NET saat autentikasi formulir diaktifkan. Kelas ini tidak dapat diwariskan.

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

public sealed class FormsAuthenticationModule : System.Web.IHttpModule

type FormsAuthenticationModule = class
    interface IHttpModule

Public NotInheritable Class FormsAuthenticationModule
Implements IHttpModule

Warisan

Object

FormsAuthenticationModule

Penerapan

IHttpModule

Contoh

Contoh berikut menggunakan peristiwa FormsAuthentication_OnAuthenticate untuk mengatur User properti saat ini HttpContext ke objek kustom IPrincipal .

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

mengatur FormsAuthenticationModule properti saat ini HttpContext.User ke IPrincipal objek yang mewakili identitas pengguna untuk permintaan saat ini ketika autentikasi Mode diatur ke Forms dalam elemen Elemen autentikasi (Skema Pengaturan ASP.NET) dari file konfigurasi aplikasi.

mengekspos FormsAuthenticationModule peristiwa Authenticate yang memungkinkan Anda menyediakan objek kustom IPrincipal untuk User properti saat ini HttpContext. Peristiwa Authenticate ini diakses dengan menentukan sub-rutin bernama FormsAuthentication_OnAuthenticate dalam file Global.asax untuk aplikasi ASP.NET Anda.

Catatan

Di IIS 7.0, menggunakan WindowsAuthenticationModule dengan FormsAuthenticationModule tidak didukung. Untuk informasi selengkapnya tentang masalah kompatibilitas dalam mode Terintegrasi, lihat Memindahkan Aplikasi ASP.NET dari IIS 6.0 ke IIS 7.0.

Konstruktor

FormsAuthenticationModule()

Menginisialisasi instans baru kelas FormsAuthenticationModule.

Metode

Dispose()	Merilis semua sumber daya, selain memori, yang digunakan oleh FormsAuthenticationModule.
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 dari instans Type saat ini. (Diperoleh dari Object)
Init(HttpApplication)	Menginisialisasi objek FormsAuthenticationModule.
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Acara

Authenticate

Terjadi ketika aplikasi mengautentikasi permintaan saat ini.

Lihat juga

• Penyedia Autentikasi Formulir