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 (ASP.NET Pengaturan Skema) dari file konfigurasi aplikasi.

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

Nota

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

Nama	Deskripsi
FormsAuthenticationModule()	Menginisialisasi instans baru dari kelas FormsAuthenticationModule.

Metode

Nama	Deskripsi
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 Type instans saat ini. (Diperoleh dari Object)
Init(HttpApplication)	Menginisialisasi objek FormsAuthenticationModule.
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Acara

Nama	Deskripsi
Authenticate	Terjadi ketika aplikasi mengautentikasi permintaan saat ini.

Lihat juga

• Penyedia Autentikasi Formulir