WindowsAuthenticationModule.Authenticate Kejadian

Definisi

Ruang nama:

System.Web.Security

Rakitan:

System.Web.dll

Terjadi ketika aplikasi mengautentikasi permintaan saat ini.

public:
 event System::Web::Security::WindowsAuthenticationEventHandler ^ Authenticate;

public event System.Web.Security.WindowsAuthenticationEventHandler Authenticate;

member this.Authenticate : System.Web.Security.WindowsAuthenticationEventHandler 

Public Custom Event Authenticate As WindowsAuthenticationEventHandler 

Jenis Acara

WindowsAuthenticationEventHandler

Contoh

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

public void WindowsAuthentication_OnAuthenticate(object sender, WindowsAuthenticationEventArgs args)
{
  if (!args.Identity.IsAnonymous)
  {
    args.User = new Samples.AspNet.Security.MyPrincipal(args.Identity);
  }
}

Public Sub WindowsAuthentication_OnAuthenticate(sender As Object, args As WindowsAuthenticationEventArgs)
  If Not args.Identity.IsAnonymous Then
    args.User = New Samples.AspNet.Security.MyPrincipal(args.Identity)
  End If
End Sub

Keterangan

Acara Authenticate dinaikkan selama AuthenticateRequest acara.

Anda dapat mengakses Authenticate peristiwa WindowsAuthenticationModule kelas dengan menentukan sub-rutin bernama WindowsAuthentication_OnAuthenticate dalam file Global.asax untuk aplikasi ASP.NET Anda.

Anda dapat menggunakan User properti objek yang WindowsAuthenticationEventArgs disediakan ke peristiwa WindowsAuthentication_OnAuthenticate untuk mengatur User properti saat ini HttpContext ke objek kustom IPrincipal . Jika Anda tidak menentukan nilai untuk User properti selama peristiwa WindowsAuthentication_OnAuthenticate , identitas Windows yang disediakan oleh IIS digunakan sebagai identitas untuk permintaan saat ini. Jika IIS menggunakan autentikasi anonim, maka Identity properti diatur ke identitas yang dikembalikan oleh GetAnonymous metode .

Peristiwa WindowsAuthentication_OnAuthenticate dinaikkan hanya ketika autentikasi Mode diatur ke Windows dan WindowsAuthenticationModule adalah modul HTTP aktif untuk aplikasi.

Catatan

Dalam IIS 7.0 yang berjalan dalam Mode Terpadu, Authenticate peristiwa WindowsAuthenticationModule tidak dinaikkan ketika modul ASP.NET WindowsAuthenticationModule dan IIS AnonymousAuthenticationModule diaktifkan. Dalam skenario ini, untuk menerima pemberitahuan autentikasi, berlangganan peristiwa AuthenticateRequestHttpApplication instans. Untuk informasi selengkapnya tentang masalah kompatibilitas dalam mode Terintegrasi, lihat Memindahkan Aplikasi ASP.NET dari IIS 6.0 ke IIS 7.0.

Lihat juga

• Penyedia Autentikasi Windows