WindowsAuthenticationModule Klasa

Definicja

Przestrzeń nazw:

System.Web.Security

Zestaw:

System.Web.dll

Ustawia tożsamość użytkownika dla aplikacji ASP.NET po włączeniu uwierzytelniania systemu Windows. Tej klasy nie można dziedziczyć.

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

public sealed class WindowsAuthenticationModule : System.Web.IHttpModule

type WindowsAuthenticationModule = class
    interface IHttpModule

Public NotInheritable Class WindowsAuthenticationModule
Implements IHttpModule

Dziedziczenie

Object

WindowsAuthenticationModule

Implementuje

IHttpModule

Przykłady

Poniższy przykład kodu używa zdarzenia WindowsAuthentication_OnAuthenticate , aby ustawić User właściwość bieżącego HttpContext obiektu na obiekt niestandardowy 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

Uwagi

Gdy uwierzytelnianie Mode jest ustawione Windowsna wartość , WindowsAuthenticationModule ustawia User właściwość bieżącego HttpContextIPrincipal obiektu na obiekt reprezentujący tożsamość systemu Windows dostarczoną przez usługi IIS dla bieżącego żądania. Jeśli usługi IIS używają uwierzytelniania anonimowego, WindowsAuthenticationModule metoda używa tożsamości zwróconej przez metodę GetAnonymous .

Obiekt WindowsAuthenticationModule uwidacznia Authenticate zdarzenie, które umożliwia podanie obiektu niestandardowego IPrincipal dla User właściwości bieżącego HttpContextobiektu . Dostęp Authenticate do zdarzenia jest uzyskiwany przez określenie podprocji o nazwie WindowsAuthentication_OnAuthenticate w pliku Global.asax dla aplikacji ASP.NET.

Uwaga / Notatka

W usługach IIS 7.0 użycie WindowsAuthenticationModule klasy z klasą FormsAuthenticationModule nie jest obsługiwane. Aby uzyskać więcej informacji na temat problemów ze zgodnością w trybie zintegrowanym, zobacz Przenoszenie aplikacji ASP.NET z usług IIS 6.0 do usług IIS 7.0.

Konstruktory

Nazwa	Opis
WindowsAuthenticationModule()	Tworzy wystąpienie klasy WindowsAuthenticationModule.

Metody

Nazwa	Opis
Dispose()	Zwalnia wszystkie zasoby, inne niż pamięć, używane przez program WindowsAuthenticationModule.
Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
Init(HttpApplication)	Inicjuje WindowsAuthenticationModule obiekt.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zdarzenia

Nazwa	Opis
Authenticate	Występuje, gdy aplikacja uwierzytelnia bieżące żądanie.

Zobacz też

• Dostawca uwierzytelniania systemu Windows