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. Klasa ta nie może być dziedziczona.

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

W poniższym przykładzie kodu użyto 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 na Windowswartość , WindowsAuthenticationModule ustawia User właściwość bieżącego HttpContext obiektu, który reprezentuje tożsamość systemu Windows dostarczaną IPrincipal 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

W usługach IIS 7.0 używanie 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

WindowsAuthenticationModule()

Tworzy wystąpienie klasy WindowsAuthenticationModule.

Metody

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

Zdarzenia

Authenticate

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

Zobacz też

• Dostawca uwierzytelniania systemu Windows