WindowsAuthenticationModule.Authenticate Kejadian
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
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 subroutine 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 GetAnonymous dikembalikan oleh 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.
